Debit-Refund

• Endpoint: POST /v1.0/debit/refund
• Tags: Indonesia SNAP

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes		Content type, value always application/json
X-TIMESTAMP	header	string	Yes		Transaction date time, in format yyyy-MM-dd'T'HH:mm:ss.SSSXXX
X-SIGNATURE	header	string	Yes		Signature need to be generated with symmetricSignature or asymmetricSignature method
ORIGIN	header	string	No		Origin domain
X-PARTNER-ID	header	string	Yes		Unique identifier for partner was generated by Payermax, or known as clientId
X-EXTERNAL-ID	header	string	Yes		Unique messaging reference identifier generated by merchant and should be unique within the same day
CHANNEL-ID	header	string	Yes		Device identification on which the API services is currently being accessed by the end user (customer)
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• X-TIMESTAMP: ""
• X-SIGNATURE: ""
• ORIGIN: ""
• X-PARTNER-ID: ""
• X-EXTERNAL-ID: ""
• CHANNEL-ID: ""
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
originalPartnerReferenceNo	string	Yes	maxLength: 64	Original transaction identifier on partner system
refundAmount	object	Yes		Net amount of the refund
refundAmount.value	number	Yes		Refund amount
refundAmount.currency	string	Yes	maxLength: 3	Refund currency
partnerRefundNo	string	Yes	maxLength: 64	Reference number from merchant for the refund
merchantId	string	No	maxLength: 32	Merchant identifier that is unique per each merchant
subMerchantId	string	No	maxLength: 32	Information of sub merchant identifier
originalReferenceNo	string	No	maxLength: 64	Original transaction identifier on Payermax system
originalExternalId	string	No	maxLength: 36	Original external identifier on header message
externalStoreID	string	No	maxLength: 64	Store identifier to indicate to which store this payment belongs to
reason	string	No	maxLength: 512	Refund reason
additionalInfo	object	Yes		Additional information
additionalInfo.version	string	Yes	maxLength: 8	API version. Current value: 1.4
additionalInfo.keyVersion	string	Yes	maxLength: 8	Signature Algorithm Version, Current value: 1
additionalInfo.refundNotifyUrl	string	No	maxLength: 256	Refund callback link, which can be configured in the background of the system

Example

{
  "merchantId": "P05010114269706",
  "partnerRefundNo": "{{orderNumber}}",
  "originalPartnerReferenceNo": "20240302141539079100054",
  "originalExternalId": "",
  "originalReferenceNo": "",
  "refundAmount": {
    "value": "1",
    "currency": "IDR"
  },
  "additionalInfo": {
    "version": "1.4",
    "keyVersion": "1",
    "refundNotifyUrl": "http:xx"
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
responseCode	string	Yes	maxLength: 7	response code
responseMessage	string	Yes	maxLength: 150	response msg
refundNo	string	Yes	maxLength: 64	Refund number identifier on Payermax system
partnerRefundNo	string	Yes	maxLength: 64	Reference number from merchant for the refund
originalReferenceNo	string	Yes	maxLength: 64	Original transaction identifier on Payermax system
originalPartnerReferenceNo	string	No	maxLength: 64	Original transaction identifier on service consumer system
refundTime	string	No	maxLength: 25	Refund time, in format yyyy-MM-dd'T'HH:mm:ss.SSSXXX
additionalInfo	object	Yes		Additional information
additionalInfo.refundStatus	string	Yes	maxLength: 32	00 - Success 03 - Pending 06 - Failed

Response Example

{
  "responseCode": "2005800",
  "responseMessage": "Request has been processed successfully",
  "originalPartnerReferenceNo": "2020102900000000000001",
  "originalReferenceNo": "2020102977770000000009",
  "originalExternalId": "10052019",
  "partnerTrxId": "LA001",
  "refundNo": "REF993883",
  "partnerRefundNo": "239850918204981205970",
  "refundAmount": {
    "value": "10000.00",
    "currency": "IDR"
  },
  "refundTime": "2020-12-21T17:21:41+07:00",
  "additionalInfo": {
    "refundStatus": "00"
  }
}