Asynchronous notification

• Endpoint: POST /delSuffixStart3
• Tags: Collection Service /Payment Tokenization

Parameters

Field	In	Type	Required	Constraints	Description
sign	header	string	Yes

Parameter Examples

• 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
merchantId	string	Yes	maxLength: 30	The unique mark assigned to the merchant by PayerMax
userId	string	Yes	maxLength: 64	The user ID by the merchant, needs to ensure the uniqueness of each user
paymentTokenID	string	Yes	maxLength: 64	PMMax token
tokenScope	string	Yes	maxLength: 16	Product Range
paymentTokenExpiry	string	Yes	maxLength: 32	Token validity period,Comply with rfc3339 specification, format: yyyy-MM-dd’T’HH:mm:ss.SSSXXX
paymentTokenStatus	string	Yes	maxLength: 16	Token status, this field is required when paying with card token
cardInfo	string	No	maxLength: 19	Mask card number, desensitized according to the first 6 and the last 4, such as 533333**2222
brand	string	No	maxLength: 32	Card groups, such as Visa, Mastercard, and dual-standard cards are returned
ifCVV	string	No	maxLength: 1	Whether CVV is required. Y: When using Token to pay, you need to input CVV again; N: CVV does not need to be entered again when using Token payment. Note: CVV is verified again according to the rules of the issuing bank
outTradeNo	string	No	maxLength: 64	he merchant order number corresponding to the original payment transaction.This field is returned only in the notification interface after the first authorization payment is successful. This field is empty when the merchant is notified again of a change in the paymentTokenStatus status.
paymentMethodType	string	Yes		payment method type, such as CARD,ONE_TOUCH
targetOrg	string	No		The target organisation, where paymentMethodType is CARD, targetOrg is empty string
accountDisplay	string	No		Mask account number, such as 63-9****72123, where paymentMethodType is CARD, accountDisplay is empty string
country	string	Yes		country code

Example

{
  "brand": "VISA",
  "ifCVV": "N",
  "cardInfo": "455701******1010",
  "outTradeNo": "20230725203208988107020",
  "paymentMethodType": "CARD",
  "paymentTokenExpiry": "2025-01-11T20:01:55.200Z",
  "paymentTokenID": "PMTOKEN20230710080439571142400031000",
  "paymentTokenStatus": "Activated",
  "targetOrg": "",
  "accountDisplay": "",
  "tokenScope": "tokenAcq",
  "userId": "victor002",
  "country": "ID"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
bizCode	string	Yes	maxLength: 6	Return code.The value ‘0000’ only represents the receipt of the notification and does not represent the order status.
message	string	No	maxLength: 32	Return message

Response Example

{
  "bizCode": "0000",
  "message": "success"
}