EXIMBAY 개발자센터

토큰 결제

토큰 결제는 결제에서 발급되는 token_id만으로 원하는 시점에 간편하게 결제를 처리할 수 있는 결제 방법을 지칭합니다.
토큰 결제를 하려면, 결제 승인 요청 결과로 발급 받은 token_id가 필요합니다. 토큰 결제 API 엔드포인트에 token_id를 Path 파라미터로 추가해서 API를 호출하세요.

요청


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" : ""
  }]
}'

요청한 API가 성공하면 resmsg로 Success가 돌아옵니다.

응답


{
"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_id가 필요합니다. 토큰 삭제 API 엔드포인트에 token_id를 Path 파라미터로 추가해서 API를 호출하세요.

요청


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 '{
  }'

요청한 API가 성공하면 resmsg로 Success가 돌아옵니다.

응답


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

토큰 카드 식별값 조회

고객이 최초 결제로 카드에 대한 토큰을 생성할 때 해당 카드 정보의 식별값을 확인할 수 있습니다. 응답 값의 card_identifier 값으로 동일한 카드인지 여부를 확인할 수 있습니다.
토큰 카드 식별값을 조회하려면 결제 승인 요청 결과로 발급 받은 token_id가 필요합니다.
토큰 카드 식별값 조회 API 엔드포인트에 token_id를 Path 파라미터로 추가해서 API를 호출하세요.

요청


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 '{
  }'

요청한 API가 성공하면 resmsg로 Success가 돌아옵니다.

응답


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

토큰 관리

토큰 결제

토큰 삭제

토큰 카드 식별값 조회