API Direct Debit - Payment Refund

Berfungsi untuk melakukan pengembalian dana

Service Info

HTTP Method	POST
Service Code	55
Http Method	POST
Path	...{version}/debit/refund

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
Authorization	String	Y	Token B2B
Authorization-Customer	String	Y	Token B2B2C
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token B2B2C: Signature Generation
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-EXTERNAL-ID	String	Y	Nomor referensi yang harus unik pada hari yg sama
CHANNEL-ID	String	Y	00001 untuk PJP and 00002 untuk non PJP

Body

Parameter	Tipe Data	Wajib	Deskripsi
merchantId	String	Y	Kode unik yang dimiliki setiap user Length: <= 64 karakter
originalPartnerReferenceNo	String	Y	ID Transaksi milik partner Length: <= 64 karakter
originalReferenceNo	String	Y	Id transaksi SpeedCash Length: <= 64 karakter
partnerRefundNo	String	Y	Kode refund milik partner / id transaksi milik partner Length: <= 64 karakter

Request samples

JSON

{
  "merchantId": "121xxxx",
  "originalPartnerReferenceNo": "2020102900000000000001",
  "originalReferenceNo": "5037424",
  "partnerRefundNo": "1234123215"
}

CURL

curl --location --request POST '../v1.0/debit/refund' \
--header 'X-TIMESTAMP: 2023-01-27T13:51:00+07:00' \
--header 'X-SIGNATURE: RwABEherf+3MTBhIf6vtju6ko+YOFFKWLGgHCD5RwX1I17JCKVn8ffc/TenEIly85InhuIcKCDqDrxbIBhaKEg==' \
--header 'X-PARTNER-ID: 085224a9-4b42-4f7d-959f-4452f8a9a1ff' \
--header 'X-EXTERNAL-ID: 024a31b6-e0c8-429a-9d41-83a2f44b6844' \
--header 'X-DEVICE-ID: android-20013adf6cdd8123f' \
--header 'CHANNEL-ID: 12345' \
--header 'Authorization: Bearer bb005fcb-dea9-499a-9e7a-bcf651b2334e' \
--header 'Authorization-Customer:Bearer 5b8bbaf8-4aca-4072-9ea8-d85bed65105f' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId": "121xxxx",
    "originalPartnerReferenceNo": "2020102900000000000001",
    "originalReferenceNo": "5037424",
    "partnerRefundNo": "1234123215",
}'

```

Response Structure

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode respons Length: <= 7 karakter
responseMessage	String	Deskripsi respons Length: <= 150 karakter
referenceNo	String	Pengidentifikasi transaksi asli pada penyedia layanan Length: <= 64 karakter
refundNo	String	Pengidentifikasi transaksi pengembalian pada sistem konsumen layanan Length: <= 32 karakter
partnerRefundNo	String	Nomor referensi dari PJP AIS untuk pengembalian Length: <= 2 karakter
refundTime	String	Tanggal pengembalian transaksi dalam format ISO 8601 Length: <= 25 karakter

Response samples

{
  "responseCode": "2005500",
  "responseMessage": "Successful",
  "referenceNo": "5037424",
  "refundNo": "12321322",
  "partnerRefundNo": "1237218936",
  "refundTime": "2023-01-27T17:28:00.667+07:00"
}

List Response Code API Direct Debit - Payment Refund

Response Code	Response Message	Description
2005500	Success	Sukses
4005501	Invalid field format { field name }	Format invalid
4005502	Invalid mandatory field {field name}	Format pada bidang wajib tidak ada atau tidak valid
4015500	Unauthorized. Invalid Signature	X-Signature salah
4095500	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4045501	Bad Request	Request header ada yang salah / kurang
4045501	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait