Token management

Kindly refer to the APIs for token payment, token deletion, and token card identification value inquiry for additional details.

Token payment

Token payment is processed exclusively using the token_id, making the payment process straightforward and efficient. Use the token_id generated during the payment authorization result. Include the token_id as a path parameter when calling the token payment API endpoint.

Request

curl --request POST 'https://api-test.eximbay.com/v1/payments/tokenbilling/{token_id}/rebill' \
  --header 'Authorization: Basic dGVzdF8xODQ5NzA1QzY0MkMyMTdFMEIyRDo=' \
  --header 'Content-Type: application/json' \
  --data '{
    "payment" : {
    "order_id" : "20220902101716",
    "currency" : "USD",
    "amount" : "1"
  },
  "merchant" : {
    "mid" : "1849705C64"
  },
  "product" : [{
    "name" : "",
    "quantity" : "",
    "unit_price" : ""
  }]
}'

A Success message will be returned by the resmsg if the requested API is success.

Response

{
"rescode" : "0000",
"resmsg" : "Success.",
"payment" : {
    "order_id" : "20220902101716",
    "currency" : "USD",
    "amount" : "1",
    "transaction_id" : "EN",
    "auth_code" : "EN",
    "transaction_date" : "EN",
    "access_country" : "EN",
    "payment_method" : "EN",
    "pay_to" : "EN",
    "lang" : "EN",
    "payment_method_name" : "EN"
  }
  "card_info" : {
    "card_holder" : "HONG GIL DONG",
    "card_number1" : "4111",
    "card_number4" : "1111"
  }
}

Token deletion

This applies to the deletion of a registered token. Once the token is deleted, it cannot be reactivated. To delete the token using the token_id generated during the payment authorization result. Include the token_id as a path parameter when calling the token deletion API endpoint.

Request

curl --request POST 'https://api-test.eximbay.com/v1/payments/tokenbilling/{token_id}/delete' \
  --header 'Authorization: Basic dGVzdF8xODQ5NzA1QzY0MkMyMTdFMEIyRDo=' \
  --header 'Content-Type: application/json; charset=UTF-8' \
  --data '{
  }'

A Success message will be returned by the resmsg if the requested API is success.

Response

{
  "rescode" : "0000",
  "resmsg" : "Success."
}

Token card identification value inquiry

To verify the identification value of the card used for the original payment, the card_identifier received in the response can be used to confirm that the card information matches the original payment card to inquiry the token card identification value using the token_id generated during the payment authorization result. Include the token_id as a path parameter when calling the token card identification value inquiry API endpoint.

Request

curl --request GET 'https://api-test.eximbay.com/v1/payments/tokenbilling/{token_id}' \
  --header 'Authorization: Basic dGVzdF8xODQ5NzA1QzY0MkMyMTdFMEIyRDo=' \
  --header 'Content-Type: application/json; charset=UTF-8' \
  --data '{
  }'

A Success message will be returned by the resmsg if the requested API is success.

Response

{
  "rescode" : "0000",
  "resmsg" : "Success.",
  "token_id" : "",
  "card_identifier" : ""
}