Notifikasi Callback

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);

Note

$fields tidak termasuk parameter signature.

Method	Merchant URL
POST	https://url.callback.merchant/

Data Request

No	Name	Type	Mandatory	Min Length	Max Length	Description
1	order	Object	M	1	12	Detail of Order
2	customer	Object	M	1	8	Detail of Customer
3	meta	Object	O	1	1	Detail of MetaData
4	card	Object	C	1	7	Detail of Card
5	result	Object	O	1	11	Result
6	signature	String	M	128	128	Signature

Sample Request

{
  "customer": {
    "id": "hajar@yahoo.com"
  },
  "order": {
    "id": "1664255905824",
    "reference": "16642559058241000000000",
    "amount": 1000,
    "currency": "IDR"
  },
  "card": {
    "mask": "512345xxxxxx0008",
    "info": {
      "brand": "MASTERCARD",
      "issuing": "BANCO DEL PICHINCHA CA",
      "type": "CREDIT",
      "subType": "STANDARD",
      "country": "ECUADOR"
    }
  },
  "meta": {
    "data": null
  },
  "result": {
    "payment": {
      "amount": 1000,
      "status": "CAPTURED",
      "statusDesc": null
    }
  },
  "signature": "8e77b8ffa3f2766e7cd5355b3a37e96feae5d924d3eb06aa374bf10cb1c95d02fa301c856d09463de4b6655815cc29d3829440bb5249b3390caaed42b15a7eb9"
}

Data Response

Sample Response

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