Disbursement

Transfer Notification

Transfer Notification merupakan layanan yang digunakan oleh Espay Disbursement untuk mengirimkan informasi hasil transfer ke Anda. Anda diminta untuk menyediakan respons berdasarkan format yang sudah disediakan, dan mendaftarkan URL Transfer Notification Anda ke Espay. Layanan Transfer Notification ini bersifat opsional.

Tipe Value
Kode Layanan
97
Nama
Transfer Notification
HTTP Method
POST

Flow

Setiap kali transfer berhasil, Espay Disbursement akan mengirimkan permintaan ke server Anda melalui URL Transfer Notification 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-notification
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
originalPartnerReferenceNo
String (64)
Y
Kode referensi merchant yang unik.
originalReferenceNo
String (64)
Y
Kode referensi dari bank.
originalExternalId
String (32)
Y
External-ID terdapat pada bagian header dari pesan.
latestTransactionStatus
String (2)
Y
Status transaksi terakhir.

Format:
  • Success: 00
  • Init: 01
  • Pending: 03
  • Canceled: 05
  • Failed: 06
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
beneficiaryAccountNo
String (34)
Y
Nomor rekening penerima.
beneficiaryBankCode
String (3)
Y
Kode bank penerima.
transactionDate
String (25)
Y
Tanggal dan waktu transaksi.

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

Contoh:
2022-08-21T14:45:28+07:00
additionalInfo
Array of Object
Y
  bankReferenceNo
Seeing (64)
O
Kode reference bank.
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+97+00 = 2009700
responseMessage
String (100)
Y
Deskripsi respons.
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

{
    "originalPartnerReferenceNo": "728cfc34138d11Gntf0001",
    "originalReferenceNo": "2026032608549464712572707854",
    "originalExternalId": "cfad1f7e-ba97-4a02-924e-c8bf1ecc6f40",
    "latestTransactionStatus": "00",
    "amount": {
        "value": "125000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "212515",
    "beneficiaryBankCode": "CENAIDJA",
    "transactionDate": "2020-12-21T14:06:21+07:00",
    "additionalInfo": {
        "bankReferenceNo": ""
    }
}



































Contoh Response Positif

{
   "responseCode":"2009700",
   "responseMessage":"Successful"
}


HTTP

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


CURL

....
Scroll to Top