callback

Handle Payment Callback

Setelah customer melakukan pembayaran, SpeedCash akan mengirimkan callback ke merchant untuk memberitahukan status pembayaran. Merchant harus mengimplementasikan service untuk menerima callback dari SpeedCash.

Kami akan mengirimkan callback ke merchant 3x sampai merchant meresponse dengan response yang diharapkan. Namun ketika percobaan callback pertama sudah sesuai maka kami tidak akan mengirimkan callback lagi.

Callback Info

Service Code	56
HTTP Method	POST
Path	{{yoururl}}/v1.0/debit/notify

Struktur Header

Header	Value	Deskripsi
Content-Type	application/json
X-Timestamp	2023-08-24T17:07:05+07:00	ISO8601 String
X-Partner-ID	{partnerId}
X-Signature	{signature}
X-External-ID	{externalId}
Channel-ID	{channelId}

Callback Payload

Parameter	Tipe Data	Deskripsi
originalPartnerReferenceNo	String	Nomor transaksi sesuai dengan field partnerReferenceNo pada saat create payment
originalReferenceNo	String	Nomor referensi pembayaran Winpay, unik pertransaksi
merchantId	String	Merchant ID
amount	Object	Object amount
amount.value	String	Nilai transaksi Length: 1-12 Allowed Chars: 0-9
amount.currency	String	Kode mata uang Length: 3 Allowed Value: IDR
latestTransactionStatus	String	Status transaksi, transaksi berhasil atau tidak berdasarkan status ini 00 - Success 01 - Initiated 02 - Paying 03 - Pending 04 - Refunded 05 - Canceled 06 - Failed 07 - Not found
additionalInfo	Object	Object additionalInfo
additionalInfo.channel	String	Channel eWallet
additionalInfo.contractId	String	Generated transaction identifier in Winpay system
additionalInfo.feeAmount	String	Biaya admin winpay
additionalInfo.nettAmount	String	Nilai total yang diterima merchant

{
  "originalPartnerReferenceNo": "2978161",
  "originalReferenceNo": "5315754",
  "originalExternalId": "2ehJuqRfgnibhQYs39VwwuguhT8GBI",
  "amount": {
    "value": "1000",
    "currency": "IDR"
  },
  "latestTransactionStatus": "00",
  "transactionStatusDesc": "success",
  "createdTime": "2024-12-04T13:17:49+07:00",
  "finishedTime": "2024-12-04T13:18:12+07:00",
  "additionalInfo": {
    "requestId": "46009",
    "title": "AGP",
    "note": "Soft Sports programming Organized"
  }
}

Expected Response

Response yang diharapkan dari merchant adalah sebagai berikut:

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