Payment Notification

Payment Notification 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.

Flow

Setiap kali customer Anda menyelesaikan pembayaran, Espay Payment Gateway akan mengirimkan permintaan ke server Anda melalui URL Payment Notification 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.

HTTP Header

Key Value
Method
HTTP Post
Connection
keep-alive
Content-Length
250
Content-Type
application/json
Accept
*/*

API URL

Method URL
HTTP
http://www.yourwebsite.com/payment.php
HTTPS
https://www.yourwebsite.com/payment.php

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Universally Unique Identifier (UUID), nomor unik yang digunakan untuk mengidentifikasi pesan.
rq_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server Espay.
password
String (32)
O
Password yang diberikan oleh tim Espay.
signature
String (64)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Payment Gateway | Hash-Based Signature.
member_id
String (20)
O
Kode merchant khusus yang diberikan oleh tim Espay.
comm_code
String (32)
Y
Merchant code yang diberikan oleh tim Espay.

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

Contoh:
Nomor transaksi, invoice id, dll.
ccy
String (3)
Y
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
amount
String (13.2)
Y
Jumlah tagihan yang harus dibayarkan.

Format:
Desimal .00

Contoh: 150000.00
debit_from_bank
String (20)
Y
Kode bank dari akun sumber.

Contoh:
008, 016, 002 dll.
debit_from
String (19)
O
Akun sumber (akun yang didebit).
debit_from_name
String (64)
O
Nama akun sumber.
credit_to_bank
String (20)
Y
Kode bank dari akun sumber.

Contoh :
008/016/002/dll
credit_to
String (19)
O
Akun tujuan (akun yang dikreditkan).
credit_to_name
String (64)
O
Nama akun tujuan.
product_code
String (32)
Y
Kode produk. Lihat daftar kode produk di sini.
product_value
String (64)
O
Nomor produk.

Contoh:
  • Tipe Kartu: VISA
  • Bank Acquirer: MANDIRI VISA
  • Bin / Acquirer Code: 002
  • Masked Card Number: 411111xxxxxx1111
card_expiry
String (6)
O
Masa kedaluwarsa kartu kredit.

Format:
YYYYMM

Contoh:
202512
message
String (32)
O
Informasi tambahan tentang pembayaran.
payment_datetime
String (19)
Y
Tanggal dan waktu pembayaran yang tercatat di sistem Espay.

Format:
YYYY-MM-DD hh:mm:ss
payment_ref
String (20)
Y
Kode yang dibuat oleh Espay sebagai identitas transaksi.
approval_code_full_bca
String (4)
C
Kode persetujuan dari BCA. Khusus pengguna kartu transaksi debit BCA.
approval_code_installment_bca
String (4)
C
Kode persetujuan dari BCA. Khusus pengguna kartu transaksi kredit BCA
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Universally Unique Identifier (UUID), nomor unik yang digunakan untuk mengidentifikasi pesan.
rs_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server merchant.
error_code
String (4)
Y
Kode respons.

Format:
  • 0 atau 0000:
    Proses validasi dari sisi merchant berhasil (Sukses).
  • Kode lainnya:
    Proses validasi dari sisi merchant tidak berhasil (Gagal).
error_message
String(32)
Y
Deskripsi respons.
signature
String (64)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Payment Gateway | Hash-Based Signature.
order_id
String (20)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Contoh:
Nomor transaksi, invoice id, dll.
reconcile_id
String (20)
Y
ID Rekonsiliasi sebagai bukti konfirmasi bahwa merchant telah berhasil menerima notifikasi.

Format:
String atau angka
reconcile_datetime
String (19)
Y
Tanggal dan waktu rekonsiliasi.

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

Example:
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 Notification Anda melalui portal Sandbox Espay. Baca cara menambahkan URL di sini.








































Contoh Permintaan

POST /path/for/notification HTTP/1.1
Host: merchant.domain
Connection: keep-alive
Content-Length: 250
Content-Type: application/x-www-form-urlencoded
Accept: */*

rq_uuid=ebf8e9df-639e-424f-8148-94d2741edd03
&rq_datetime=2020-10-01T22:55:14+07:00
&password=ServicePassword
&signature=1e6be48271e94f8f08ca0ad52d4ee4c8b1d2155b471a7d34720bcca09d80e220
&member_id=SGWMERCHANT&comm_code=SGWMERCHANT
&order_id=ESPTRX21183111
&ccy=IDR
&amount=150000.00
&debit_from_bank=014
&debit_from=2731726215
&debit_from_name=PaulWeller
&credit_to_bank=014
&credit_to=5250287544
&credit_to_name=SteveMarriott
&product_code=KLIKPAY
&message=
&payment_datetime=2020-10-0124:55:14
&payment_ref=338746162U313G
&approval_code_full_bca=
&approval_code_installment_bca=












































































Contoh Respons Positif

{
  "rq_uuid": "ebf8e9df-639e-424f-8148-94d2741edd03",
  "rs_datetime": "2024-04-01T22:55:14+07:00",
  "error_code": "0000",
  "error_message": "Success",
  "signature": "952b489cc6bb70fca23cbb0716f1f9bbb5c9c5918056427ed8d375ebb9ff0f18",
  "order_id": "ESPTRX21183111",
  "reconcile_id": "2020100121183111",
  "reconcile_datetime": "2024-04-01T22:56:14+07:00"
}


Contoh Respons Negatif

{
  "rq_uuid":"ebf8e9df-639e-424f-8148-94d2741edd03",
  "rs_datetime":"2024-04-01T22:55:14+07:00",
  "error_code":"0014",
  "error_message":"invalid order id"
}


CURL


curl --location 'https://yourwebsite.xyz//payment' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'rq_uuid=ebf8e9df-639e-424f-8148-94d2741edd03' \
--data-urlencode 'rq_datetime=2024-04-01T22:55:14+07:00' \
--data-urlencode 'password=ServicePassword' \
--data-urlencode 'signature=e8666bc49b291c3cb49808dd2e4cf05efeaaae3db49045ad420c3b6d393dc76c' \
--data-urlencode 'member_id=' \
--data-urlencode 'comm_code=SGWDIGALLERY' \
--data-urlencode 'order_id=ESPTRX21183111' \
--data-urlencode 'ccy=IDR' \
--data-urlencode 'amount=150000.00' \
--data-urlencode 'debit_from_bank=014' \
--data-urlencode 'debit_from=2731726215' \
--data-urlencode 'debit_from_name=PaulWeller' \
--data-urlencode 'credit_to_bank=014' \
--data-urlencode 'credit_to=5250287544' \
--data-urlencode 'credit_to_name=SteveMarriott' \
--data-urlencode 'product_code=KLIKPAY' \
--data-urlencode 'card_expiry=202512' \
--data-urlencode 'message=' \
--data-urlencode 'payment_datetime=2024-04-01T22:55:14+07:00' \
--data-urlencode 'payment_ref=338746162U313G' \
--data-urlencode 'approval_code_full_bca=' \
--data-urlencode 'approval_code_installment_bca='
Scroll to Top