Inquiry Status

Inquiry Status adalah layanan opsional yang disediakan oleh Espay Payment Gateway yang memungkinkan Anda memeriksa status transaksi terakhir Anda.

Tipe Value
Kode Layanan
26
Nama
Inquiry Status
HTTP Method
POST

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Espay Payment Gateway akan memberikan respons dalam bentuk JSON.

API URL

Environment URL
Sandbox
Port of HTTPS (443)
https://sandbox-api.espay.id/apimerchant/v1.0/transfer-va/status
Production
Port of HTTPS (443)
https://api.espay.id/apimerchant/v1.0/transfer-va/status
Nama Tipe Mandatory Keterangan
Content-Type
String
Y
Isi konten permintaan Anda.

Contoh:
application/json
X-TIMESTAMP
String (25)
Y
Tanggal dan waktu lokal customer saat ini.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Contoh:
2024-03-14T07:49:28+07:00
X-SIGNATURE
String (255)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Signature Asymmetric
X-EXTERNAL-ID
String (32)
Y
String Numerik. Kode referensi yang bersifat unik pada hari yang sama.
X-PARTNER-ID
String (50)
Y
Merchant code yang diberikan oleh tim Espay.
CHANNEL-ID
String (5)
Y
Kode channel.

Value:
ESPAY
Authorization-Customer
String (150)
C
Kode token B2B2C. Khusus Espay -> Bank.
Y: Yes, O: Optional, C: Conditional

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
partnerServiceId
String (8)
Y
Kode partner.

Format:
padding space + ESPAY

Value:
" ESPAY"
customerNo
String (20)
Y
Merchant code yang diberikan oleh tim Espay.
virtualAccountNo
String (28)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Contoh:
Nomor transaksi, invoice id, dll.
inquiryRequestId
String (128)
O
Id unik Inquiry dari Espay.
paymentRequestId
String (128)
O
Id unik payment dari Espay.
additionalInfo
Object
C
  billNo
String (32)
C
Nomor tagihan untuk virtual account static dari layanan virtual account (remark4).
  isPaymentNotif
String(1)
O
Kondisi transaksi.

Format:
  • Pengiriman ulang Payment Notification: Y
  • update trx_status menjadi S (berhasil) di portal Espay : N
      productCode
    String (32)
    C
    Kode produk. Khusus pengecekan status pengguna EDC atau pembayaran offline.
    Y: Yes, O: Optional, C: Conditional

    Parameter Respons

    Parameter Tipe Mandatory Keterangan
    responseCode
    String (7)
    Y
    Kode respon.

    Format:
    Kode HTTP + Kode Layanan + Kode Error

    Contoh:
    200+26+00 = 2002600.
    responseMessage
    String (150)
    Y
    Deskripsi respon.
    virtualAccountData
    Object
    Y
      partnerServiceId
    String (8)
    Y
    Kode partner.

    Format:
    padding space + ESPAY

    Value:
    " ESPAY"
      customerNo
    String (20)
    Y
    Merchant code dari tim Espay.

    Example:
    SGWYESSISHOP
      paymentFlagStatus
    String (2)
    Y
    Status pembayaran.

    Format:
    • Success: S
    • Failed: F
    • Suspect: SP
    • In Process: IP
    • Expired: EX
    • Waiting Correction: WC
      paymentFlagReason
    Object
        english
    String (64)
    Y
    Deksripsi transaksi (versi bahasa inggris).
        indonesia
    String (64)
    Y
    Deksripsi transaksi (versi bahasa indonesia).
      virtualAccountNo
    String (28)
    Y
    Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

    Contoh:
    Nomor transaksi, invoice id, dll.
      inquiryRequestId
    String (128)
    Y
    Id unik Inquiry dari Espay.
      paymentRequestId
    String (128)
    Y
    Id unik payment dari Espay.
      paidAmount
    Object
    Y
        value
    String (16.2)
    Y
    Total pembayaran.

    Format:
    Desimal .00 (ISO 4217)

    Contoh:
    150000.00
        currency
    String (3)
    Y
    Kode mata uang transaksi.

    Format:
    • Rupiah: IDR
      totalAmount
    Object
    Y
        value
    String (16.2)
    Y
    Total pembayaran.

    Format:
    Desimal .00

    Contoh:
    150000.00
        currency
    String (3)
    Y
    Kode mata uang transaksi.

    Format:
    • Rupiah: IDR
      trxDateTime
    String (25)
    Y
    Tanggal dan waktu pembayaran.

    Format:
    yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

    Contoh:
    2022-08-21T14:56:11+07:00
      transactionDate
    String(25)
    Y
    Tanggal dan waktu pembuatan transaksi.

    Format:
    yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

    Example:
    2022-08-21T14:45:28+07:00
      billDetails
    Array of Object
        billAmount
    Object
    Y
          value
    String (16.2)
    Y
    Total pembayaran.

    Format:
    Desimal .00 (ISO 4217)

    Contoh:
    150000.00
          currency
    String(3)
    Y
    Kode mata uang transaksi.

    Format:
    • Rupiah: IDR
        billDescription
    Object
    Y
          english
    String (18)
    Y
    Deksripsi transaksi (versi bahasa inggris).
          indonesia
    String (18)
    Y
    Deksripsi transaksi (versi bahasa Indonesia).
        billNo
    String (32)
    C
    Nomor tagihan untuk Virtual Account Static dari layanan virtual account (remark4).
    additionalInfo
    Object
    C
      trxId
    String (18)
    Y
    ID transaksi dari Espay.
      expiredDatetime
    String (25)
    O
    Waktu dan Tanggal kedaluwarsa transaksi

    Format:
    yyyy-MM-ddThh:mi:ssTZD

    Contoh:
    2022-08-21T14:56:11+07:00
      memberCode
    String (50)
    O
    Kode member.

    Format:
    • Virtual Account Statis: Merchant Code
    • Virtual Account Dinamis: Virtual Account Number
    • E-Money: Merchant Code
      debitFrom
    String (19)
    O
    Akun sumber (akun yang didebit).
      debitFromName
    String (64)
    O
    Nama akun sumber.
      debitFromBank
    String (5)
    O
    Kode bank dari akun sumber.

    Contoh :
    008, 016, 002, dll.
      creditTo
    String (19)
    O
    Akun tujuan (akun yang dikreditkan).
      creditToName
    String (64)
    O
    Nama akun tujuan.
      creditToBank
    String (5)
    O
    Kode bank dari akun sumber.

    Contoh :
    008, 016, 002, dll.
      productCode
    String (50)
    O
    Kode produk. Lihat disini
      productValue
    String (128)
    O
    Product value / payer phone number / payer masking card number / payer card type.
      rrn
    String (12)
    O
    Kode unik dari pembayaran QRIS.
      approvalCode
    String (64)
    O
    Kode persetujuan dari bank.
      token
    String (128)
    O
    Token dari bank.
      userId
    String (128)
    O
    ID User.
      message
    Object
    O
    Informasi tambahan dari bank.
      feeType
    String (5)
    O
    Tipe pembayaran.

    Format:
    • Seller Fee: S
    • Buyer Fee: B
      txFee
    String (16.2)
    O
    Biaya transaksi.

    Format:
    Desimal .00 (ISO 4217)

    Contoh:
    4400.00
       paymentRef
    String (18)
    O
    ID transaksi dari Espay.
       paymentRemark
    String (18)
    O
    Deskripsi transaksi dari Inquiry.
       traceNumber
    String (32)
    C
    Trace number. Khusus EDC atau pembayaran offline.
    Y: Yes, O: Optional, C: Conditional

    Try It!

    Anda bisa coba masukkan data sesuai dengan input yang telah disediakan. Setelah itu Anda submit dan lihat hasilnya!

    Request

    Value

    Response































    Contoh Header
    
Content-Type:application/json
X-TIMESTAMP:2024-03-14T07:49:28+07:00
X-SIGNATURE:jXYIExgLGVYjAD1Shmj+1ezQV8pMgys+udT2Y02iHpqOkBf4eCNFKqAhlZXaMqnugMlJ9IGvXhgx5B/3LPD/uvR61oAvGBG6Q3IYQ4m2mqFbBOakbh0al5QEyWmHCL+Ixr1hUIcvWLQstAwR04B4tsXDnEaeEDV32yqXxVYS+n7O3VUUIpilcoC3FEagfg4Z9tkN97vNVzw8FMgszc+JekKRtM7fi8Xi/A2cmSg8P9Rwk3soIRCTPX7QlQ8asbqqvckci0D1t4fx/2IqkpVpMWmBl+FTKbiobjd+5z/yCu1SdtctJz/klMK38Og3jyLsi2jVkHC4HoqJBpXzCdDXbA==
X-EXTERNAL-ID:c4c48989-9a32-446c-82e6-869a5737a40f
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY




























    Contoh Permintaan
    

{
  "partnerServiceId": " ESPAY",
  "customerNo": "SGWYESSISHOP",
  "virtualAccountNo": "DIGORDER000001",
  "inquiryRequestId": "abcdef-123456-abcdef",
  "paymentRequestId": "abcdef-123456-fedcba",
  "additionalInfo": {
      "billNo": "invoiceid0001",
      "isPaymentNotif":"Y",
      "productCode": "EDCWS"
  }
}





























    Contoh Respons Positif
    
{
  "responseCode": "2002600",
  "responseMessage": "Successful",
  "virtualAccountData": {
      "partnerServiceId": " ESPAY",
      "customerNo": "SGWYESSISHOP",
      "paymentFlagStatus": "IP",
      "paymentFlagReason": {
          "english": "In Process",
          "indonesia": "Dalam Proses"
      },
      "virtualAccountNo": "DIGORDER000001",
      "inquiryRequestId": "abcdef-123456-abcdef",
      "paymentRequestId": "abcdef-123456-fedcba",
      "paidAmount": {
          "value": "154400.00",
          "currency": "IDR"
      },
      "totalAmount": {
          "value": "150000.00",
          "currency": "IDR"
      },
      "trxDateTime": "2024-03-14T17:54:45+07:00",
      "transactionDate": "2024-03-14T17:52:31+07:00",
      "billDetails": [
          {
              "billAmount": {
                "value": "150000.00",
                "currency": "IDR"
              },
              "billDescription": {
                  "english": "Invoice DIGORDER000001",
                  "indonesia": "Invoice DIGORDER000001"
              },
              "billNo": "invoiceid0001"
          }
      ]
  },
  "additionalInfo": {
      "trxId": "ESP171041355218DT",
      "expiredDatetime": "2024-03-14 19:52:32",
      "memberCode": "SGWYESSISHOP",
      "debitFrom": "16095902XXXX",
      "DebitFromName": "BCA",
      "DebitFromBank": "014",
      "creditTo": "1111111111111",
      "creditToName": "1111111111111",
      "creditToBank": "014",
      "productCode": "BCAATM",
      "productValue": "4490525531976673",
      "rrn": 229018831918293,
      "approvalCode": 123456787654,
      "token": "",
      "userId": null,
      "feeType": "B",
      "userId": "4400.00",
      "traceNumber": “7007432222”
  }
}


    Contoh Response Negatif
    
    
{
  "responseCode": "4012600",
  "responseMessage": "Unauthorized. Invalid Signature from Client"
}















































    CURL
    
curl --location 'https://sandbox-api.espay.id/apimerchant/v1.0/transfer-va/status' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2024-03-14T07:49:28+07:00' \
--header 'X-SIGNATURE: jXYIExgLGVYjAD1Shmj+1ezQV8pMgys+udT2Y02iHpqOkBf4eCNFKqAhlZXaMqnugMlJ9IGvXhgx5B/3LPD/uvR61oAvGBG6Q3IYQ4m2mqFbBOakbh0al5QEyWmHCL+Ixr1hUIcvWLQstAwR04B4tsXDnEaeEDV32yqXxVYS+n7O3VUUIpilcoC3FEagfg4Z9tkN97vNVzw8FMgszc+JekKRtM7fi8Xi/A2cmSg8P9Rwk3soIRCTPX7QlQ8asbqqvckci0D1t4fx/2IqkpVpMWmBl+FTKbiobjd+5z/yCu1SdtctJz/klMK38Og3jyLsi2jVkHC4HoqJBpXzCdDXbA==' \
--header 'X-EXTERNAL-ID: c4c48989-9a32-446c-82e6-869a5737a40f' \
--header 'X-PARTNER-ID: SGWYESSISHOP' \
--header 'CHANNEL-ID: ESPAY' \
--header 'Authorization: Basic Og==' \
--data '{
    "partnerServiceId": " ESPAY",
    "customerNo": "SGWYESSISHOP",
    "virtualAccountNo": "DIGORDER000001",
    "inquiryRequestId": "abcdef-123456-abcdef",
    "paymentRequestId": "abcdef-123456-abcdef",
    "additionalInfo": {
		"billNo": "invoiceid0001",
        "isPaymentNotif":"Y",
        "productCode": "EDCWS"
    }
}'





    Scroll to Top