Create
- Description: Tokenize credit card that can later used to make a payment without store the card data by yourself
- Path: /tokenization/add-token
- Method: POST
- Request Header: Content-Type: application/json
#
Request ParametersParameter | Type | Required | Default | Description |
---|---|---|---|---|
merchantId | string | Y | Merchant identifier | |
userId | string | Y | Merchant's user identifier | |
reason | string | O | Reason to create token | |
callbackUrl | object | O | ||
callbackUrl.success | string | O | For redirect to merchant website, after successful tokenize | |
callbackUrl.fail | string | O | For redirect to merchant website, after fail tokenize | |
callbackUrl.notify | string | O | Merchant backend listening endpoint, to receive notification | |
lang | string | O | Default language ("zh-HK" or "en"), browser detected if not provide | |
showLang | boolean | O | 1 | Display language options 1:Show 0:Hide |
Example:
#
Response ParametersParameter | Type | Required | Description |
---|---|---|---|
responseCode | string | Y | Payment Gateway response code |
message | string | Y | Payment Gateway response message |
data | string | Y | URL to hosted tokenize page |
Example:
After getting the response data, you need to guide your user by redirecting to the URL to complete the tokenization of credit card, Apple pay or Google pay.