Payment webhooks

Transactions

The Payment WebHook endpoint is used to receive payment successful notifications from WinuPay. This endpoint should be implemented by merchants to process transaction status updates..

POST{notification_url}

This endpoint requires the webhooks.payment scope.

Headers

timestampstringrequired

UNIX timestamp

Examples:"20240117193352"

timezonestringrequired

Timezone

Examples:"Asia/Shanghai"

signaturestringrequired

RSA signature of the body object

Examples:"ovTdLBu+BN8+NSvEmG/rQARwBgbZuywMAKdH5ShOKKnJU00bG5idAMj5pSe9mcU28HQvJ5+mWkaQS4mTC8N7ZqKEPgIacKo0VQFGUBd2LNO77tmxvBmjrEkSy3BzYyAX7lCvaKfLC7wMw1C1PU3Ku7EiBVo5oIxvwM0kBfh9qZbD62aTzYrfokw0lIYV2wQadzjDMIgeL6KaAI6Yqfb1pdvNXEma9eGUBwf3GAWZzn4JmCVxXJ1rVhe0kY2Xf266nl7doe0NvoT5emIjbCdxRpf2FQyPBy2SUad+FQ3HYm69RL9OK/qC1bpQhu9X90Nd1GlmvaZlsvTCeg/p4hBvkw=="

Body

application/json

ll_transaction_idstringrequired

WinuPay payment order ID

merchant_transaction_idstringrequired

external_identifier,Merchant payment order ID,

payment_dataobjectrequired

Payment 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": "2022012601122644",
    "merchant_transaction_id": "693100628120965120",
    "payment_data": {
      "account_date": "20220126",
      "exchange_rate": "1.00000000",
      "payment_amount": "1.20",
      "payment_currency_code": "EUR",
      "payment_status": "PS",
      "payment_time": "20220126141430",
      "settlement_amount": "1.20",
      "settlement_currency_code": "EUR"
    }
  }'

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