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