CodeGrant
About 736 wordsAbout 2 min
2025-03-07
Integration Process
Sign-up Process
The sign-up process is as follows:
Developers call the sign-up interface to obtain the wallet sign-up address authUrl. Users visit the authUrl to complete sign-up, triggering the sign-up success asynchronous notification to obtain the payment credential token.
Unbinding
There are two scenarios for initiating unbinding:
- Merchant calls API for unbinding
- Wallet users can unbind on the wallet side.
Below is the API list that needs to be integrated
If unbinding is needed, call the unbinding interface , after cancellation the token will become invalid.
Payment Process
Below is the API list that needs to be integrated
Call the order and payment interface to pass in token, bizType and merchantUserId.
Key Input Parameters:
| Parameter Name | Type | Required | Description |
|---|---|---|---|
| token | String | M | Existing field, pass the token obtained after authorization or sign-up completion |
| bizType | String | M | Existing field, new type identifier for authentication authorization, fixed as "CodeGrant" |
| merchantUserId | String | M | Member ID, the user's member ID in the merchant website |
When calling the order and payment interface, merchantUserId must be passed in the input parameters and must be consistent with the merchantUserId passed during authentication, otherwise it will return an error that the token does not exist
Example of order and payment interface input parameters:
{
"accId": "2023042011040310224447",
"clientId": "2023042011040310224",
"signType": "SHA256",
"sign": "{{Sign}}",
"version": "1.0",
"bizContent": {
"captureDelayHours": 0,
"amount": 100,
"currency": "HKD",
"requestId": "{{requestId}}",
"payResultUrl": "https://www.baidu.com",
"notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/notify",
"merchantTransactionId": "{{merchantTransactionId}}",
"shopperIP": "192.168.1.1",
"token": "7dda0a6f6958105204fd6637001f900efd9b3168c948b68b6f7f2bf063eadf97",
"bizType": "CodeGrant",
"merchantUserId": "126048960513465",
"paymentMethod": {
"type": "AlipayHK"
},
"customer": {
"email": "pass@pingpongx.com"
},
"device": {
"orderTerminal": "02"
}
}
}Sign-up Asynchronous Notification
Payment Methods
Specific payment methods that support CodeGrant Payment Method List