Inquiry

Endpoint for inquiry the transaction detail / transaction status.

##JSON Attributes

Name	Data Type	Required	Details
transaction_id	String	Yes	MCP Transaction ID
external_id	String(64)	Yes	unique string from merchant, used in signature
order_id	String(255)	Yes	Only allow '-' for special characters, not unique, may be duplicated
payment_method	String	Yes	fixed value: wallet
payment_channel	String	Yes	fixed value: SHOPEEPAY, OVO, LINKAJA, DANA, NOBU, VIRGO

##Information

Hostname	https://api-stage.ifortepay.id
Path	/ewallet/v2/inquiry
HTTP Method	POST

##Headers

Key	Format	Required	Value
Content-Type	application/json	M
Authorization	String	M
x-req-signature	String	M
x-version	String	M	v3

##Example

Body raw

{
    "transaction_id": "{{mcp_transaction_id}}",
    "external_id": "{{merchant_external_id}}",
    "order_id": "{{order_id}}",
    "payment_channel": "{{channel_name: OVO / SHOPEEPAY / NOBU / DANA / LINKAJA / VIRGO}}",
    "payment_method": "wallet"
}

Example Request

curl

curl --location 'https://api-stage.ifortepay.id/ewallet/v2/inquiry' \
--header 'Authorization: {{Authorization}}' \
--header 'x-req-signature: {{x-req-signature}}' \
--header 'Content-Type: application/json' \
--header 'x-version: v3' \
--data '{
    "transaction_id": "{{mcp_transaction_id}}",
    "external_id": "{{merchant_external_id}}",
    "order_id": "{{order_id}}",
    "payment_channel": "{{channel_name: OVO / SHOPEEPAY / NOBU/ DANA / LINKAJA / VIRGO}}",
    "payment_method": "wallet"
}'

go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api-stage.ifortepay.id/ewallet/v2/inquiry"
  method := "POST"

  payload := strings.NewReader(`{
    "transaction_id": "{{mcp_transaction_id}}",
    "external_id": "{{merchant_external_id}}",
    "order_id": "{{order_id}}",
    "payment_channel": "{{channel_name: OVO / SHOPEEPAY / NOBU/ DANA / LINKAJA / VIRGO}}",
    "payment_method": "wallet"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "{{Authorization}}")
  req.Header.Add("x-req-signature", "{{x-req-signature}}")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("x-version", "v3")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

js

var axios = require('axios');
var data = JSON.stringify({
  "transaction_id": "{{mcp_transaction_id}}",
  "external_id": "{{merchant_external_id}}",
  "order_id": "{{order_id}}",
  "payment_channel": "{{channel_name: OVO / SHOPEEPAY / NOBU/ DANA / LINKAJA / VIRGO}}",
  "payment_method": "wallet"
});

var config = {
  method: 'post',
maxBodyLength: Infinity,
  url: 'https://api-stage.ifortepay.id/ewallet/v2/inquiry',
  headers: { 
    'Authorization': '{{Authorization}}', 
    'x-req-signature': '{{x-req-signature}}', 
    'Content-Type': 'application/json', 
    'x-version': 'v3'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

php

use GuzzleHttp\Client;

$client = new Client();
$headers = [
  'Authorization' => '{{Authorization}}',
  'x-req-signature' => '{{x-req-signature}}',
  'Content-Type' => 'application/json',
  'x-version' => 'v3'
];
$body = '{
  "transaction_id": "{{mcp_transaction_id}}",
  "external_id": "{{merchant_external_id}}",
  "order_id": "{{order_id}}",
  "payment_channel": "{{channel_name: OVO / SHOPEEPAY / NOBU/ DANA / LINKAJA / VIRGO}}",
  "payment_method": "wallet"
}';

$request = new Request('POST', 'https://api-stage.ifortepay.id/ewallet/v2/inquiry', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

Example Response

{
  "external_id": "test123456",
  "reference_id": "TEST-123456",
  "transaction_id": "123456789-123456789-123456789",
  "order_id": "order-123456",
  "currency": "IDR",
  "response_code": "00",
  "transaction_status": "ACTIVE",
  "item_details": [
    {
      "item_id": "item-1",
      "name": "Item Name",
      "amount": 1000,
      "qty": 1,
      "description": "Your item description"
    }
  ],
  "payment_details": {
    "amount": 1000,
    "total_amount": 1000,
    "expired_time": "2021-05-06T05:05:47.115+07:00",
    "paid_time": "2021-05-06T04:52:28.573+07:00",
    "transaction_time": "2021-05-06T04:50:47.313+07:00",
    "transaction_description": "MC Payment Inquiry Order Details"
  },
  "payment_method": "WALLET",
  "payment_channel": "SHOPEEPAY",
  "additional_data": "Your Free Text",
  "customer_details": {
    "phone": "08880000000",
    "email": "customer@email.com",
    "full_name": "John Doe"
  },
  "callback_url": "https://merchant.callback.url",
  "issuer": "{{issuer_name, e.g: shopee, linkaja, ovo}}",
  "wallet_details": {
    "id": "0800000000",
    "id_type": "HP"
  },
  "billing_address": {
    "phone": "628888888888",
    "address": "Alamat saya",
    "city": "Jakarta",
    "postal_code": "12345",
    "country": "Indonesia",
    "full_name": "billing customer fullname"
  },
  "shipping_address": {
    "phone": "628888888888",
    "address": "Alamat saya",
    "city": "Jakarta",
    "postal_code": "12345",
    "country": "Indonesia",
    "full_name": "billing customer fullname"
  }
}