Payment

Payment merupakan layanan yang digunakan oleh Espay Payment Gateway untuk memberi tahu bahwa pembayaran dari customer Anda telah berhasil dilakukan. Anda diminta untuk menyediakan respons sesuai dengan format yang telah disediakan, dan mendaftarkan URL Payment Anda di Portal Sandbox Espay.

Tipe Value
Kode Layanan
25
Nama
Payment
HTTP Method
POST

Flow

Setiap kali customer Anda menyelesaikan pembayaran, Espay Payment Gateway akan mengirimkan permintaan ke server Anda melalui URL Payment yang telah Anda daftarkan pada Portal Sandbox Espay. Anda diminta untuk memberikan respons terhadap permintaan tersebut sesuai dengan format yang telah disediakan, dalam bentuk JSON.

API URL

URL Merchant Endpoint Keterangan
https://yourdomain.com
.../v1.0/transfer-va/payment
Merchant domain URL.
Port of HTTPS (443).
TLS 1.2
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.

Contoh:
SGWYESSISHOP
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.

Contoh:
SGWYESSISHOP
virtualAccountNo
String (28)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Contoh:
Nomor transaksi, invoice id, dll.
trxId
String (18)
Y
ID transaksi 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.
  • Rupiah: IDR
totalAmount
Object
Y
  value
String (16.2)
Y
Total pembayaran, sama dengan Inquiry.

Format:
Desimal .00 (ISO 4217)

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

Format:
  • Rupiah: IDR
trxDateTime
String(25)
Y
Tanggal dan waktu dari sistem Espay.

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

Contoh:
2022-08-21T14:56:11+07:00
additionalInfo
Object
C
  transactionStatus
String(2)
Y
Status pembayaran.

Format:
  • Success: S
  • Failed: F
  • Suspect: SP
  • In Process: IP
  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.
  message
Object
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
  paymentRef
String (18)
O
Kode yang dibuat oleh Espay sebagai identitas transaksi.
  paymentRemark
String (18)
O
Deskripsi transaksi dari Inquiry.
  rrn
String (12)
O
Kode unik dari pembayaran QRIS.
  approvalCode
String (6)
O
Kode persetujuan pembayaran kartu kredit.
  token
String (128)
O
Token kartu kredit dari bank.
  userId
String (128)
O
ID user.
  traceNumber
String (32)
C
Trace number. Khusus EDC atau pembayaran offline.
  terminalId
String (32)
C
ID mesin terminal. Khusus EDC atau pembayaran offline.
  cardType
String (10)
C
Tipe kartu.

Format:
  • credit
  • debit
billDetails
Object
C
  billNo
String (32)
C
Id merchant dari parameter remark4 Virtual Account (khusus virtual account static).
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+25+00 = 2002500.
responseMessage
String (150)
Y
Deskripsi respons.
virtualAccountData
Object
  partnerServiceId
String (8)
Y
Kode partner.

Format:
padding space + ESPAY

Value:
" ESPAY"
  customerNo
String (20)
Y
Merchant code yang diberikan oleh tim Espay.

Contoh:
SGWYESSISHOP
  virtualAccountNo
String (28)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Contoh:
Nomor transaksi, invoice id, dll.
  virtualAccountName
String (255)
Y
Nama customer.
  paymentRequestId
String (128)
Y
Id unik payment dari Espay.
  totalAmount
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
  billDetails
Array of Objects
Y
    billDescription
Object
Y
      english
String (18)
Y
Deksripsi transaksi (versi bahasa inggris).
      indonesia
String (18)
Y
Deksripsi transaksi (versi bahasa indonesia).
additionalInfo
Object
  reconcileId
String (128)
Y
ID Rekonsiliasi.
  reconcileDatetime
String (25)
Y
Tanggal dan waktu rekonsiliasi.

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

Contoh:
2022-08-21T14:56:11+07:00
Y: Yes, O: Optional, C: Conditional

Pendaftaran URL

Pastikan format URL dan respons yang Anda buat sudah sesuai dengan panduan dokumentasi ini. Selanjutnya, segera daftarakan URL Payment Anda melalui portal Sandbox Espay. Baca cara menambahkan URL disini.


































Contoh Header

Content-Type:application/json
X-TIMESTAMP:2024-03-14T07:49:28+07:00
X-SIGNATURE:e4G1zJpQGKRc6VjeIgEt914/S4JLCi8/JeTpqY/3zL+m/yye8uXtiF1uBztkJOGM3eotMOLlAswDbqOAYgCowmX2PjLF8fT9AcyhI4uFVMo+MbB4kwXKWi+xNxFJVk5SvMJJ6JOeItNw/NWHbwPEahXlPZdTVj1isc148H39aiT+FPRS3ezufgyOo4/TYWAelp2W32rZrrM3VZx2pkZO0rcxi4IvW3OJvKZrWXFKJ9+z55PZ0LHdn7j/+RYIv5ARjfo2Tga1HvBPIUZ7173KsnPgcH6bONGb7g5uszP23S2huGOlMPcUS6fc4Cuag8jFNTiRSMh+Iy3ikW2KWFSLxw==
X-EXTERNAL-ID:6a40adae-0850-494d-8173-22354a776175
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY






























Contoh Permintaan

  {
      "partnerServiceId": " ESPAY", 
      "customerNo": "SGWYESSISHOP", 
      "virtualAccountNo": "ORDER0001",
      "trxId": "ESP1661161958ZQEG", 
      "paymentRequestId": "abcdef-123456-abcdef", 
      "paidAmount": {
            "value": "12345678.00",
            "currency": "IDR"
      },
      "totalAmount": {
            "value": "12345678.00",
            "currency": "IDR"
      },
      "trxDateTime": "2022-08-21T14:56:11+07:00", 
      "additionalInfo": {
            "transactionStatus": "S",
            "memberCode": "SGWYESSISHOP",
            "debitFrom": "16095902XXXX",
            "debitFromName": "BRI",
            "debitFromBank": "002",
            "creditTo": "665050XXXX",
            "creditToName": "BRI",
            "creditToBank": "002",
            "productCode": "BRIATM",
            "productValue": "16095902XXXX",
            "message": {
                  "CHANNEL_FLAG": "W"
            },
            "feeType": "S",
            "txFee": "4400",
            "paymentRef": "ESP1661161958ZQEG",
            "paymentRemark": "Bayar",
            "rrn": "220822000288",
            "approvalCode": "220822000288",
            "token": "2023011167618274122",
            "userId": "2306291049P89VWB",
            "traceNumber": "7999999901",
            "terminalId": "10380579",
            "cardType": "credit"
      },
      "billDetails": [{
            "billNo": "invoiceid0001"
      }]
  }
















































































































Contoh Respons Positif

  {
    "responseCode": "2002500",
    "responseMessage": "Success",
    "virtualAccountData": {
        "partnerServiceId": " ESPAY",
        "customerNo": "SGWYESSISHOP",
        "virtualAccountNo": "DIGOERDER00001",
        "virtualAccountName": "Jokul Doe",
        "paymentRequestId": "abcdef-123456-abcdef",
        "totalAmount": {
            "value": "890000.00",
            "currency": "IDR"
        },
        "billDetails": [
            {
                "billDescription": {
                    "english": "Tagihan No 123456",
                    "indonesia": "Invoice 22123"
                }
            }
        ]
    },
    "additionalInfo": {
        "reconcileId": "2020100121183111",
        "reconcileDatetime": "2022-08-21T14:56:11+07:00"
    }
  }




Contoh Respons Negatif

{
    "responseCode": "4012500",
    "responseMessage": "Unauthorized Signature"
}


CURL

  
  curl --location 'https://digallery-me.xyz/api/v1.0/transfer-va/payment' \
  --header 'X-TIMESTAMP: 2024-03-14T07:49:28+07:00' \
  --header 'X-SIGNATURE: SGWYESSISHOP' \
  --header 'X-EXTERNAL-ID: 6a40adae-0850-494d-8173-22354a776175' \
  --header 'X-PARTNER-ID: SGWYESSISHOP' \
  --header 'CHANNEL-ID: ESPAY' \
  --header 'Content-Type: application/json' \
  --data '{
      "partnerServiceId": " ESPAY", 
      "customerNo": "SGWDIGALLERY", 
      "virtualAccountNo": "ORDER0001",
      "trxId": "ESP1661161958ZQEG", 
      "paymentRequestId": "abcdef-123456-abcdef", 
      "paidAmount": {
            "value": "12345678.00",
            "currency": "IDR"
      },
      "totalAmount": {
            "value": "12345678.00",
            "currency": "IDR"
      },
      "trxDateTime": "2022-08-21T14:56:11+07:00", 
      "additionalInfo": {
            "transactionStatus": "S",
            "memberCode": "SGWYESSISHOP",
            "debitFrom": "16095902XXXX",
            "debitFromName": "BRI",
            "debitFromBank": "002",
            "creditTo": "665050XXXX",
            "creditToName": "BRI",
            "creditToBank": "002",
            "productCode": "BRIATM",
            "productValue": "16095902XXXX",
            "message": {
                  "CHANNEL_FLAG": "W"
            },
            "feeType": "S",
            "txFee": "4400",
            "paymentRef": "ESP1661161958ZQEG",
            "paymentRemark": "Bayar",
            "rrn": "220822000288",
            "approvalCode": "220822000288",
            "token": "2023011167618274122",
            "userId": "2306291049P89VWB"
      },
      "billDetails": [{
    "billNo": "invoiceid0001"
      }]
  }
  '
Scroll to Top