Notifikasi Disbursement

Untuk alasan keamanan, kami sangat menyarankan Merchant untuk memastikan bahwa notifikasi yang diterima oleh backend Merchant, benar-benar dikirim oleh sistem Finpay. Ada dua cara untuk melakukan hal tersebut:

1. Validasi respons dengan meminta pengecekan status transaksi ke Finpay menggunakan Layanan Cek Status. Alur ini merupakan metode yang paling aman untuk memverifikasi keaslian Callback. Jika status transaksi sesuai dengan Callback maka Merchant dapat melanjutkan proses order.
2. Validasi respon dengan membandingkan signature key yang diterima dari sistem Finpay saat mengirimkan Callback dengan signature yang dibuat oleh Merchant. Jika signature key tidak sesuai, maka silahkan abaikan Callback yang dikirimkan oleh Finpay dan Anda tidak perlu memproses transaksi tersebut.

Berikut adalah logika Signature Key untuk menghasilkan Signature Key:

hash_hmac("sha512", json_encode($fields), $key);

Environment	Method	URL
Development	POST	https://devo.finnet.co.id/pg/payment/card/v1.0/disbursement/notify
Production	POST	https://live.finnet.co.id/pg/payment/card/v1.0/disbursement/notify

Data Request

No	Name	Type	Mandatory	Min Length	Max Length	Description
1	amount	Object	O	1	2	Detail of amount
2	originalReferenceNo	String	M	1	64	Original transaction identifier on service provider system
3	beneficiaryAccountNo	String	M	1	64	Original beneficiary account number on service provider system
4	originalPartnerReferanceNo	String	O	1	64	Original Transaction identifier on service consumer system
5	latestTransactionStatus	String	M	1	2	00 - Success 01 - Initiated 02 - Paying 03 - Pending 04 - Refunded 05 - Cancelled 06 - Failed 07 - Not found
6	beneficiaryAccountName	String	M	1	64	Original beneficiary account name on service provider system
7	beneficiaryBackCode	String	M	1	6	Original beneficiary bank code on service provider system
8	transactionDate	String	O	1	50	ISO 8601 format
9	additionalInfo	Object	O	1	18	Additional Info

Sample Request

{
    "amount": {
        "currency": "IDR",
        "value": "1000.00"
    },
    "originalReferenceNo": "20240921061636205623",
    "beneficiaryAccountNo": "500654309",
    "originalPartnerReferenceNo": "240921-9865405967",
    "latestTransactionStatus": "00",
    "beneficiaryAccountName": "Karman Prasasta",
    "beneficiaryBankCode": "91014",
    "transactionDate": "2024-09-21T06:16:37+07:00",
    "additionalInfo": {
        "notes": null
    }
}

Data Response

Sample Response

{
  "responseCode": "2000000",
  "responseMessage": "Success",
  "processingTime": 0.6609270572662354
}