Refund Notification
Notifikasi callback untuk status refund.
- Status 02 (Refund Success) atau 05 (Refund Fail) akan memicu callback.
- Paylabs menembak ke
notifyUrl yang dikirim Merchant saat membuat refund request.
- Jika tidak ada response sukses, notifikasi dikirim ulang total 8 kali (1s, 5s, 10s, 30s, 60s, 300s, 900s, 1800s).
URL: nilai notifyUrl saat kirim request refund
HTTPMethod: POST
EndpointUrl: Path dari URL, misalnya URL=https://merchant-domain.com/v2/qris/notify → Path=/v2/qris/notify
Cara Membuat Signature
| Field Name | Type | Value | Required |
|---|
| Content-Type | String(30) | Isi dengan nilai "application/json;charset=utf-8" | Yes |
| X-TIMESTAMP | String(29) | Waktu saat ini, dengan format 2022-09-16T16:58:47.964+07:00 | Yes |
| X-SIGNATURE | String(64) | Signature. Untuk selengkapnya cek | Yes |
| X-PARTNER-ID | String(20) | Merchant ID | Yes |
| X-REQUEST-ID | String(64) | ID unik merepresentasikan setiap request yang dikirim | Yes |
Kode Error
| Parameter | Type | Required | Remarks |
|---|
| requestId | String(64) | Yes | Kode unik untuk setiap request |
| errCode | String(32) | Yes | 0 adalah sukses, untuk lainnya bisa lihat tabel |
| errCodeDes | String(128) | No | Deskripsi terkait error |
| merchantId | String(20) | Yes | ID unik yang disediakan oleh payment gateway ke merchant |
| storeId | String(30) | No | Jika Merchant memiliki cabang dan ingin membuat order dengan ID cabang |
| paymentType | String(20) | Yes | Nama tipe pembayaran, cek tabel Tipe Pembayaran |
| amount | Decimal(12,2) | Yes | Nominal dalam Rupiah Indonesia, with 2 decimal places |
| merchantRefundNo | String(32) | Yes | Nomor Refund |
| merchantTradeNo | String(32) | Yes | Kode unik yang dibuat oleh Merchant untuk setiap transaksi |
| platformTradeNo | String(32) | No | Nomor order di platform Paylabs |
| createTime | String(16) | No | yyyyMMddHHmmss |
| successTime | String(16) | No | yyyyMMddHHmmss |
| status | String(2) | No | 02: Refund berhasil, 03: Refund dalam proses, 06: Refund gagal |
| +paymentMethodInfo | Object | No | Informasi tambahan terkait Payment channel |
| transFeeRate | Decimal(6,6) | No | Rate Transaksi, mendukung enam angka belakang koma |
| transFeeAmount | Decimal(12,2) | No | Biaya, mendukung dua angka belakang koma |
| totalTransFee | Decimal(12,2) | No | Total rate biaya layanan transaksi (tidak termasuk vatFee), mendukung dua angka belakang koma |
| vatFee | Decimal(12,2) | No | Pajak, mendukung dua angka belakang koma |
Cara Membuat Signature
| Field Name | Type | Value | Required |
|---|
| Content-Type | String(30) | Isi dengan nilai "application/json;charset=utf-8" | Yes |
| X-TIMESTAMP | String(29) | Waktu saat ini, dengan format 2022-09-16T16:58:47.964+07:00 | Yes |
| X-SIGNATURE | String(64) | Signature. Untuk selengkapnya cek | Yes |
| X-PARTNER-ID | String(20) | Merchant ID | Yes |
| X-REQUEST-ID | String(64) | ID unik merepresentasikan setiap request yang dikirim | Yes |
Kode Error
| Parameter | Type | Required | Remarks |
|---|
| requestId | String(64) | Yes | Kode unik untuk setiap request |
| errCode | String(32) | Yes | 0 adalah sukses, untuk lainnya bisa lihat tabel |
| errCodeDes | String(128) | No | Deskripsi terkait error |
| merchantId | String(20) | Yes | Merchant ID |
| storeId | String(30) | No | Jika Merchant memiliki cabang dan ingin membuat order dengan ID cabang |