Refund webhooks

Transactions

The Refund WebHook endpoint is used to receive refund successful notifications from EFundPay. This endpoint should be implemented by merchants to process refund status updates.

POST{notification_url}

This endpoint requires the webhooks.refund scope.

Headers

timestampstringrequired

UNIX timestamp

Examples:"20240117193352"

timezonestringrequired

Timezone

Examples:"Asia/Shanghai"

signaturestringrequired

RSA signature of the body object

Examples:"base64_rsa_signature_example"

Body

application/json

ll_transaction_idstringrequired

EFundPay refund order ID

merchant_transaction_idstringrequired

Merchant refund order ID

original_transaction_idstringrequired

Original merchant payment order ID

refund_dataobjectrequired

Refund data

Response

application/json

Successful Response

codestringrequired

response code.

Examples:"200"

messagestringrequired

response message.

Examples:"SUCCESS"

curl --request POST   --url {notification_url}   --header 'timestamp: "20240117193352"'   --header 'timezone: "Asia/Shanghai"'   --header 'signature: "ovTdLBu+BN8...Bvkw=="'   --header 'Content-Type: application/json'   --data '{
    "ll_transaction_id": "2022010406411871",
    "merchant_transaction_id": "test2022010110240583981",
    "original_transaction_id": "refund10167310",
    "refund_data": {
      "account_date": "20220104",
      "actual_refund_amount": 5599,
      "actual_refund_currency_code": "USD",
      "reason": "do not like the goods",
      "refund_amount": 5599,
      "refund_currency_code": "USD",
      "refund_status": "SUCCESS",
      "refund_time": "20220104180837",
      "settlement_currency_code": "USD"
    }
  }'

{
  "code": "200",
  "message": "SUCCESS"
}