2.1.49 Get token
Path:/openapi/card/sdk/access/token
Method:POST
Content-Type:application/json
Response Content-Type:application/json
Description:
Only some cards need to use this interface. To use this interface, you need to have your own app and then connect the SDK we provide in the app.
Use this interface to obtain the token information required after connecting the SDK. In the SDK, you can query the pin code, query card details, authorize 3ds transactions, and other operations.
Please contact the administrator to obtain the document of app connection SDK.
Note ⚠️: Subsequent request body and response body on the interface may add more fields; therefore, when using this interface, new fields that are not recognized need to be ignored to prevent errors
Example Request:
{
"card_id": "1089744560000011928",
"token_type":"SDK_CARD_ACCESS_TOKEN",
"single_use":false
}
Request Parameter:
| Parameter name | Type | Required | Description |
|---|---|---|---|
| card_id | string | true | Card ID |
| token_type | string | true | Token Type，Values：SDK_CARD_ACCESS_TOKEN（sdk access token） |
| single_use | boolean | false | is use sdk；use sdk the values is true，init sdk the value is false |
API Response:
| Parameter name | Type | Description |
|---|---|---|
| code | string | Error code |
| data | Object | Response data object |
| card_id | string | This card_id not request body‘s card_id，it equals to sdk’s cardId |
| app_card_id | string | APP Card ID，it equals to sdk’s appCardId |
| app_cardholder_id | string | APP Cardholder ID，it equals to sdk’s appCardholderId |
| token | string | Token，it equals to sdk’s token |
| expires_in_seconds | integer | Expires time，in seconds |
| msg | string | Error message |
Example Response:
{
"code": "00000",
"msg": "ok",
"data": {
"card_id": "CA1651791760457761",
"app_card_id": "crd_xemr6hppo64u3erbvs2gmq7o7u",
"app_cardholder_id": "crh_kmvkhwdbdtoujbuzw26vtailom",
"token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2FjY2Vzcy5zYW5kYm94LmNoZWNrb3V0LmNvbSIsIm5iZiI6MTczNDQxNDM3MiwiaWF0IjoiMTczNDQxNDM3MiIsImV4cCI6MTczNDQyODc3MiwiYXVkIjpbImFjY291bnRzIiwiYmFsYW5jZXMiLCJkaXNwdXRlcyIsImZpbGVzIiwiZmluYW5jaWFsLWFjdGlvbnMiLCJmbG93IiwiZm9yd2FyZCIsImZ4IiwiZ2F0ZXdheSIsImluc3RydW1lbnRzIiwiaXNzdWluZyIsIm1pZGRsZXdhcmUiLCJub3RpZmllciIsInBheW1lbnQtc2Vzc2lvbnMiLCJwYXltZW50cyIsInBheW91dHMiLCJyZXBvcnRzIiwic2Vzc2lvbnMiLCJ0cmFuc2ZlcnMiLCJ2YXVsdCJdLCJzY29wZSI6WyJhY2NvdW50cyIsImJhbGFuY2VzIiwiYmFsYW5jZXM6dmlldyIsImRpc3B1dGVzOmFjY2VwdCIsImRpc3B1dGVzOnByb3ZpZGUtZXZpZGVuY2UiLCJkaXNwdXRlczp2aWV3IiwiZmlsZXMiLCJmaW5hbmNpYWwtYWN0aW9ucyIsImZpbmFuY2lhbC1hY3Rpb25zOnZpZXciLCJmbG93OmV2ZW50cyIsImZsb3c6d29ya2Zsb3dzIiwiZm9yd2FyZCIsImZ4IiwiZ2F0ZXdheSIsImdhdGV3YXk6cGF5bWVudCIsImdhdGV3YXk6cGF5bWVudC1hdXRob3JpemF0aW9ucyIsImdhdGV3YXk6cGF5bWVudC1jYW5jZWxsYXRpb25zIiwiZ2F0ZXdheTpwYXltZW50LWNhcHR1cmVzIiwiZ2F0ZXdheTpwYXltZW50LWRldGFpbHMiLCJnYXRld2F5OnBheW1lbnQtcmVmdW5kcyIsImdhdGV3YXk6cGF5bWVudC12b2lkcyIsImluc3RydW1lbnRzIiwiaXNzdWluZzpjYXJkLWNvbmZpZ3VyYXRpb24tcmVhZCIsImlzc3Vpbmc6Y2FyZC1jb25maWd1cmF0aW9uLXdyaXRlIiwiaXNzdWluZzpjYXJkLW1hbmFnZW1lbnQtcmVhZCIsImlzc3Vpbmc6Y2FyZC1tYW5hZ2VtZW50LXdyaXRlIiwiaXNzdWluZzpjYXJkLW1nbXQiLCJpc3N1aW5nOmNsaWVudCIsImlzc3Vpbmc6Y29udHJvbHMtcmVhZCIsImlzc3Vpbmc6Y29udHJvbHMtd3JpdGUiLCJpc3N1aW5nOmRpc3BhdGNoaW5nIiwiaXNzdWluZzpkaXNwYXRjaGluZy1yZWFkIiwiaXNzdWluZzpkaXNwYXRjaGluZy13cml0ZSIsImlzc3Vpbmc6ZGlzcHV0ZXMtcmVhZCIsImlzc3Vpbmc6ZGlzcHV0ZXMtd3JpdGUiLCJpc3N1aW5nOnBhcnRuZXIiLCJpc3N1aW5nOnBheW1lbnQiLCJpc3N1aW5nOnByb3ZpZGVyIiwiaXNzdWluZzp0cmFuc2FjdGlvbnMtcmVhZCIsImlzc3Vpbmc6dHJhbnNhY3Rpb25zLXdyaXRlIiwibWlkZGxld2FyZSIsIm1pZGRsZXdhcmU6bWVyY2hhbnRzLXNlY3JldCIsIm5vdGlmaWVyOmV2ZW50cyIsIm5vdGlmaWVyOndvcmtmbG93cyIsInBheW1lbnQtc2Vzc2lvbnMiLCJwYXltZW50czpzZWFyY2giLCJwYXlvdXRzOmJhbmstZGV0YWlscyIsInJlcG9ydHMiLCJyZXBvcnRzOnZpZXciLCJzZXNzaW9uczphcHAiLCJzZXNzaW9uczpicm93c2VyIiwidHJhbnNmZXJzIiwidmF1bHQiLCJ2YXVsdDppbnN0cnVtZW50cyJdLCJjbGllbnRfaWQiOiJhY2tfdHl1M2wzZzZlN2tldGlka2JwdzVpa2hzbnUiLCJja29fY2xpZW50X2lkIjoiY2xpXzJxc2hreG5td3NsZWpiemtpam9vdmd0eTJlIiwiY2tvX2VudGl0eV9pZCI6ImVudF9kYmd2bHM2dW5udGQ3dmZqYnVrbTdhbWJ4cSIsImNrb192YXVsdF9hY2NvdW50X2lkIjoidmFjdF8yY3ZraTJjcXF2a3V4ZGV6Y3M1ZTV4cWN2eSIsImp0aSI6IjI5ODIxREY5OTM1NTRDMjVFQUMxNkJDOEYwM0NGNzA5IiwiY2tvX2NhcmRob2xkZXJfaWQiOiJjcmhfa212a2h3ZGJkdG91amJ1encyNnZ0YWlsb20iLCJja29fc2luZ2xlX3VzZSI6ZmFsc2V9.aEIySZGP5_RqBPPpAQm-CqFFbWFn9pxuPyyxPsSX9yUNc-HC_tHiuMzOJoC6zBW9VooTjGV0u3Zng9dnLZSlBDT4AkJ-B12NVtQF3IB2BekS3lVTZV_7Ed1uLCY6X-rtGulMajnsc885nFy8oj5Kjhi3hXYcOUaM_ITX3v7tzfVahKtS4-92Zz8iU7sAJPzddVF-iskOwBytLYq9tUT9Ijx5vnalFiE2EgE8cn5K1iSo9CN_Y_VFHyxNpfO7Y9N83Fl2LwjnBCA1stVgWoGltTAmSE-jVzUFM9ENfK3cjU3Fa-VCEb5-Jn-kI1-Ua80bCE_VJLS8GffUDCwkEYoITLddMOXcphpu83QP0lMPKFPnzuzTb9-oZ5uAeaqFYJCVsDECDAPXBsm93XZB4vunMu-Jr9G6p7RRbBr6mGrwpLq-jGOXVGf2-Hl4SChPqlQQfIZSWBcPJOhNQS7ysYu97pQXCaHdFGP9QMST_tSF4H3PErBmWtKmi2xLloa_kUhdIejJ9TuLA42H-FEyGb5UMm6hJix2G6WrQrqpA6z_GaOiVf0oTIoG72-48osKzEwtzn8DsFAaTVSKyCIiUcMVDuLvtqINbiY97_EeuWQBiOTrVL1YS_QNi2fohc_I7cSXvZ4bd4apij81o-ThEmwRkSLB0QfTtRtkY5EmCEfZBq8",
"expires_in_seconds": 14400
}
}