Create Token Order
Request URL: POST
/checkout/tokenization/create
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
transactionId | String(128) | Required | Merchant unique transaction ID, generally used to prevent repeated submission of one order |
orderId | String(128) | Required | Merchant order ID, can be repeated but only one successful transaction exists |
currency | String(3) | Required | Currency (Example: CNY/USD) |
amount | Number(12,3) | Required | Transaction amount |
transactionIp | String(128) | Required | Cardholder transaction IP |
appId | Number(20) | Required | System -> Website App -> APP |
callbackUrl | String(255) | Required | 3D/Checkout callback URL (Generally used for page display logic, such as redirecting to the original product page) |
notificationUrl | String(255) | Required | Asynchronous notification URL, if this parameter is not empty, a notification will be sent to this address after the transaction is completed (usually used to process order status) |
productInfos | Array | Required | Product information (ProductInfo Details) |
transactionMethod | String(32) | Optional | Payment method, default is Default (Payment Method Details) |
billingAddress | Object | Required | Note: Country field is required Billing information (BillingAddress Details) |
shippingAddress | Object | Optional | Shipping information (ShippingAddress Details) |
secure | Boolean | Optional | Whether to request 3D transaction, true for 3D transaction,This parameter does not relate to Google Pay™. |
browser | Object | Conditionally Required | Required for 3D transaction, Request browser parameters (Browser Details) |
Request Example
json
{
"transactionType": "Tokenization",
"transactionId": "123456",
"currency": "USD",
"amount": "130.00",
"appId": "123456",
"callbackUrl": "https://domain/callback",
"notificationUrl": "https://test-gw2.mzmcs.cc/webhook/test/notify",
"transactionIp": "127.0.0.1",
"productInfos": [
{
"quantity": 1,
"price": 60,
"productLink": "https://noemi.biz",
"sku": "771,361386",
"productName": "Handcrafted Plastic Table"
},
{
"quantity": 2,
"price": 35,
"productLink": "http://reid.org",
"sku": "771,361386",
"productName": "Unbranded Metal Pants"
}
],
"secure": false,
"billingAddress": {
"firstName": "Gross",
"lastName": "Schmidt",
"country": "CA",
"email": "[email protected]",
"city": "Longueuil",
"address": "3226 rue Saint-Charles",
"phone": "450-928-5752",
"state": "Quebec",
"zipCode": "J4H 1M3"
},
"shippingAddress": {
"firstName": "Gross",
"lastName": "Schmidt",
"country": "CA",
"email": "[email protected]",
"city": "Longueuil",
"address": "3226 rue Saint-Charles",
"phone": "450-928-5752",
"state": "Quebec",
"zipCode": "J4H 1M3"
}
}Response Example
Request Success -> Redirect to check out using redirectUrl parameter
json
{
"code": 301,
"isTest": true,
"appId": 123456,
"uniqueId": "1669548151356891137",
"billDescription": "*Description",
"message": "order processing",
"timestamp": 1686886273516,
"transactionAmount": "8.88",
"transactionAt": "2023-06-16 11:31:12",
"transactionCardNumber": "420000******0000",
"transactionCurrency": "USD",
"transactionId": "123456",
"transactionMessage": "Redirect",
"redirectUrl": "https://domain/checkout/2200040333507540993"
}