External Transfer

Transfer Confirmation

Transfer Confirmation merupakan layanan yang digunakan oleh Espay Disbursement untuk mengetahui detail transaksi. Anda diminta untuk menyediakan respons berdasarkan format yang sudah disediakan, dan mendaftarkan URL Transfer Confirmation Anda ke Espay. Layanan Transfer Confirmation ini bersifat mandatory untuk Anda yang menggunakan layanan BI Fast, Transfer, RTGS, ataupun SKN.

Tipe Value
Kode Layanan
70
Nama
Transfer Credit Confirmation
HTTP Method
POST

Flow

Setiap kali terjadi transaksi baru, Espay Disbursement akan mengirimkan permintaan ke server Anda melalui URL Transfer Confirmation yang telah terdaftar pada Espay. Anda diminta untuk memberikan respons dalam bentuk JSON menggunakan format yang disediakan.

API URL

URL Merchant Endpoint Keterangan
https://yourdomain.com
.../api/v1.0/transfer-confirmation
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 Disbursement | Asymmetric Signature.
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
String
C
Token akses dari B2B. Pelajari Access Token B2B.

Format:
Bearer (access token).

Contoh:
Bearer ZDE1MTQxM2QwODE2Zj UyNjk3ZmY0NTA3ZDgwZ Tg2ZDcyNmQ4MTNlYw
Y: Yes, O: Optional, C: Conditional

Parameter Pemintaan

Parameter Tipe Mandatory Keterangan
partnerReferenceNo
String (32)
Y
Kode referensi merchant yang unik.
merchantId
String (32)
Y
Merchant code yang diberikan oleh tim Espay.

Contoh:
SGWYESSISHOP
amount
Array of Object
  value
String (16.2)
Y
Total transaksi.

Format:
Desimal .00 (ISO 4217)

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

Format:
  • Rupiah: IDR
sourceAccountNo
String (64)
O
Nomor rekening sumber.

Format:
Hashing sha256 sourceAccountNo + partnerReferenceNo
sourceBankCode
String (3)
O
Kode bank sumber. Lihat kode bank di sini.

Format:
Hashing sha256 sourceBankCode + partnerReferenceNo.
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
responseCode
String (7)
Y
Kode respons. Lihat kode respons di sini.

Format:
Kode HTTP + Kode Layanan + Kode Error

Contoh:
200+70+00 = 2007000.
responseMessage
String (100)
Y
Deskripsi respons. Lihat deskripsi respons di sini.
partnerReferenceNo
String (32)
Y
Kode referensi merchant.
amount
Array of Object.
  value
String (16.2)
Y
Total transaksi.

Format:
Desimal .00 (ISO 4217)

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

Format:
  • Rupiah: IDR
transactionDate
String (25)
Y
Tanggal dan waktu transaksi.

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

Contoh:
2022-08-21T14:56:11+07:00
beneficiaryAccountNo
String (64)
Y
Nomor rekening penerima.

Format
Hashing sha256 beneficiaryAccountNo + partnerReferenceNo
beneficiaryBankCode
String (64)
Y
Kode bank penerima.

Format
Hashing sha256 beneficiaryBankCode + partnerReferenceNo
beneficiaryAccountName
String (64)
Y
Nama rekening penerima.

Format
Hashing sha256 beneficiaryAccountName + partnerReferenceNo
sourceBankCode
String (64)
O
Kode bank sumber.

Format
Hashing sha256 sourceBankCode + partnerReferenceNo
sourceAccountNo
String (64)
O
Nomor rekening sumber.

Format:
Hashing sha256 sourceAccountNo + partnerReferenceNo
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 Transfer Confirmation Anda melalui portal Sandbox Espay. Baca cara menambahkan URL disini.





































Contoh Header

Content-Type: application/json
X-TIMESTAMP: 2025-11-24T14:13:48+07:00
X-ORIGIN: api.espay.id
X-SIGNATURE: X5bFkGFAsx64TwleSGSVR1x7KCaknwcCiwBXUJP0OFKn2CXUqe6IQuYPwI85mCT5dBMWOlDax/5mZnLzPDtvaKsxOXPGvn16/069WQcZ/C1wT8rlwGBB7O8xmS3JjOPweirmieUpY7PG6s/WdRj4rcVpyGy2rBAiBXmJIdwxw/1lvI5oH4sWnmiUDs+5JDWP5U7fGTjj4gSpzNCl15MFeYA32686NYWxZMofE84UD3E0O3OXBEmu78qlbXYlz4l8cQyNs7w3Wf4Za3NMoiGF82esqOltEN0os5smqgrPAH/KfEgjerST5eZJlwcXokcrek3UK7ecAmnBdkwjWaPGVw==
CHANNEL-ID: ESPAY
X-EXTERNAL-ID: a699352d-48c9-40ac-ac1a-b4db4a37a3f6
X-PARTNER-ID: SGWMERCHANTESPAY



































Contoh Permintaan

{
    "partnerReferenceNo": "PI1760427801K7FFBFST08TST0047",
    "merchantId": "SGWMERCHANTESPAY",
    "amount": {
        "value": "300000.00",
        "currency": "IDR"
    },
    "sourceAccountNo": "66e7ccabdf6c342a0744091a860987f8ac7f9a1fb601cba9ea4a952c87e973be",
    "sourceBankCode": "e2a2dfd5d7273cff3c709982c2dfe6e861f32650d82248b1d4a1dc57024ec284"
}






























Contoh Response Positif

{
    "responseCode": "2007000",
    "responseMessage": "Successful",
    "partnerReferenceNo": "PI1760427801K7FFBFST08TST0047",
    "amount": {
        "value": "300000.00",
        "currency": "IDR"
    },
    "transactionDate": "2025-11-24 14:13:48",
    "beneficiaryAccountNo": "9554f22685f027878789544c1703509d524c55f5929b5a3b2ba8ab3e5a8cf6a5",
    "beneficiaryBankCode": "f161d6f36c1c08da1997d4cc608c72fc53f63de95d6ff9f22abed9fca5ceeff1",
    "beneficiaryAccountName": "8bc17ff44a8d054140e5f7724f4828fa5ad0d8c8216247f59729228d400b5def",
    "sourceBankCode": "e2a2dfd5d7273cff3c709982c2dfe6e861f32650d82248b1d4a1dc57024ec284",
    "sourceAccountNo": "66e7ccabdf6c342a0744091a860987f8ac7f9a1fb601cba9ea4a952c87e973be"
}


HTTP

POST /api/v1.0/transfer-confirmation
HTTP/1.1
Host: {{domain merchant}}


CURL

....
Scroll to Top