2. PSP Payment Callback
This asynchronous callback interface allows tenants (third-party systems) to notify the CRM about payment results. After receiving the payment result from the Payment Service Provider (PSP), the tenant can immediately invoke this interface to inform the CRM of the outcome.
POST
{CRM_Callback_URL}/pay/callback
Headers
Ket | Value |
---|---|
crm-pay-token | The token CRM generates |
Request Body
Name | Type | Required | Description |
---|---|---|---|
merchant_id | string | Mandatory | Merchant ID generated by CRM after PSP Integration is created. |
order_no | string | Mandatory | Unique Order ID generated by CRM for each payment. |
transaction_id | string | Optional | Transaction ID generated by the third party. |
amount | number | Mandatory | Payment amount. |
currency | string | Mandatory | Currency code (e.g., USD, EUR). |
time | number | Mandatory | Payment completion time (Unix timestamp in milliseconds). |
status | number | Mandatory | Payment status (0 : Fail, 1 : Success, 2 : Processing). |
user_id | string | Optional | CRM customer ID. |
sign | string | Mandatory | Data signature (refer to Signature Algorithm |
Sample Request
{
"merchant_id": "f23eb3a856284d0a87913e33ed581852",
"order_no": "td0bhyp3lqm1",
"transaction_id": "98765434567876",
"amount": 432.98,
"currency": "USD",
"time": 1631696419516,
"user_id": "ewem9cab",
"status": 1,
"sign": ""
}
Expected HTTP status code
- 204