curl --request POST \
--url http://localhost:8080/cardcenter/api/v1/tokenization/inquiry \
--header 'Content-Type: application/json' \
--data '
{
"merchantInfo": {
"merchantId": "<string>",
"subMerchantId": "<string>"
},
"tokenRequestId": "<string>",
"merchantUserId": "<string>",
"tokenId": "<string>",
"tokenType": "<string>"
}
'import requests
url = "http://localhost:8080/cardcenter/api/v1/tokenization/inquiry"
payload = {
"merchantInfo": {
"merchantId": "<string>",
"subMerchantId": "<string>"
},
"tokenRequestId": "<string>",
"merchantUserId": "<string>",
"tokenId": "<string>",
"tokenType": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
merchantInfo: {merchantId: '<string>', subMerchantId: '<string>'},
tokenRequestId: '<string>',
merchantUserId: '<string>',
tokenId: '<string>',
tokenType: '<string>'
})
};
fetch('http://localhost:8080/cardcenter/api/v1/tokenization/inquiry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8080",
CURLOPT_URL => "http://localhost:8080/cardcenter/api/v1/tokenization/inquiry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'merchantInfo' => [
'merchantId' => '<string>',
'subMerchantId' => '<string>'
],
'tokenRequestId' => '<string>',
'merchantUserId' => '<string>',
'tokenId' => '<string>',
'tokenType' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:8080/cardcenter/api/v1/tokenization/inquiry"
payload := strings.NewReader("{\n \"merchantInfo\": {\n \"merchantId\": \"<string>\",\n \"subMerchantId\": \"<string>\"\n },\n \"tokenRequestId\": \"<string>\",\n \"merchantUserId\": \"<string>\",\n \"tokenId\": \"<string>\",\n \"tokenType\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://localhost:8080/cardcenter/api/v1/tokenization/inquiry")
.header("Content-Type", "application/json")
.body("{\n \"merchantInfo\": {\n \"merchantId\": \"<string>\",\n \"subMerchantId\": \"<string>\"\n },\n \"tokenRequestId\": \"<string>\",\n \"merchantUserId\": \"<string>\",\n \"tokenId\": \"<string>\",\n \"tokenType\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/cardcenter/api/v1/tokenization/inquiry")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"merchantInfo\": {\n \"merchantId\": \"<string>\",\n \"subMerchantId\": \"<string>\"\n },\n \"tokenRequestId\": \"<string>\",\n \"merchantUserId\": \"<string>\",\n \"tokenId\": \"<string>\",\n \"tokenType\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": "<string>",
"msg": "<string>",
"msgParams": {},
"data": [
{
"tokenRequestId": "<string>",
"tokenId": "<string>",
"tokenType": "<string>",
"tokenStatus": "<string>",
"merchantUserId": "<string>",
"tokenData": {
"maskedCardInfo": "<string>",
"cardHolderName": "<string>",
"cardExpiry": "<string>",
"cardBin": "<string>",
"cardScheme": "<string>",
"cardType": "<string>",
"cardIssuerName": "<string>",
"cardIssueCountryCode": "<string>"
},
"billingAddress": {
"countryCode": "<string>",
"region": "<string>",
"city": "<string>",
"postalCode": "<string>",
"address": "<string>"
},
"merchantInfo": {
"merchantId": "<string>",
"subMerchantId": "<string>"
}
}
],
"success": true,
"fail": true
}Tokenization Inquiry
curl --request POST \
--url http://localhost:8080/cardcenter/api/v1/tokenization/inquiry \
--header 'Content-Type: application/json' \
--data '
{
"merchantInfo": {
"merchantId": "<string>",
"subMerchantId": "<string>"
},
"tokenRequestId": "<string>",
"merchantUserId": "<string>",
"tokenId": "<string>",
"tokenType": "<string>"
}
'import requests
url = "http://localhost:8080/cardcenter/api/v1/tokenization/inquiry"
payload = {
"merchantInfo": {
"merchantId": "<string>",
"subMerchantId": "<string>"
},
"tokenRequestId": "<string>",
"merchantUserId": "<string>",
"tokenId": "<string>",
"tokenType": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
merchantInfo: {merchantId: '<string>', subMerchantId: '<string>'},
tokenRequestId: '<string>',
merchantUserId: '<string>',
tokenId: '<string>',
tokenType: '<string>'
})
};
fetch('http://localhost:8080/cardcenter/api/v1/tokenization/inquiry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8080",
CURLOPT_URL => "http://localhost:8080/cardcenter/api/v1/tokenization/inquiry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'merchantInfo' => [
'merchantId' => '<string>',
'subMerchantId' => '<string>'
],
'tokenRequestId' => '<string>',
'merchantUserId' => '<string>',
'tokenId' => '<string>',
'tokenType' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:8080/cardcenter/api/v1/tokenization/inquiry"
payload := strings.NewReader("{\n \"merchantInfo\": {\n \"merchantId\": \"<string>\",\n \"subMerchantId\": \"<string>\"\n },\n \"tokenRequestId\": \"<string>\",\n \"merchantUserId\": \"<string>\",\n \"tokenId\": \"<string>\",\n \"tokenType\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://localhost:8080/cardcenter/api/v1/tokenization/inquiry")
.header("Content-Type", "application/json")
.body("{\n \"merchantInfo\": {\n \"merchantId\": \"<string>\",\n \"subMerchantId\": \"<string>\"\n },\n \"tokenRequestId\": \"<string>\",\n \"merchantUserId\": \"<string>\",\n \"tokenId\": \"<string>\",\n \"tokenType\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/cardcenter/api/v1/tokenization/inquiry")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"merchantInfo\": {\n \"merchantId\": \"<string>\",\n \"subMerchantId\": \"<string>\"\n },\n \"tokenRequestId\": \"<string>\",\n \"merchantUserId\": \"<string>\",\n \"tokenId\": \"<string>\",\n \"tokenType\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": "<string>",
"msg": "<string>",
"msgParams": {},
"data": [
{
"tokenRequestId": "<string>",
"tokenId": "<string>",
"tokenType": "<string>",
"tokenStatus": "<string>",
"merchantUserId": "<string>",
"tokenData": {
"maskedCardInfo": "<string>",
"cardHolderName": "<string>",
"cardExpiry": "<string>",
"cardBin": "<string>",
"cardScheme": "<string>",
"cardType": "<string>",
"cardIssuerName": "<string>",
"cardIssueCountryCode": "<string>"
},
"billingAddress": {
"countryCode": "<string>",
"region": "<string>",
"city": "<string>",
"postalCode": "<string>",
"address": "<string>"
},
"merchantInfo": {
"merchantId": "<string>",
"subMerchantId": "<string>"
}
}
],
"success": true,
"fail": true
}Body
Merchant info.
Show child attributes
Show child attributes
Tokenization request ID sent from Merchant. It will also be used for idempotent check.
64The merchant's userId must be unique for each user of merchants. Either merchantUserId or tokenId must be provided to look up bound cards.
64The tokenization id of card info. The merchant needs to securely store this field, and subsequently, when initiating user payments or backend deductions, this token can be used to replace the user's card information for payment.
64Types of requested tokenization: CARD. Required unless tokenId is provided.
32Response
OK
Standard API response envelope.
Result code. "0" indicates success; any other value indicates failure.
Human-readable message corresponding to the result code.
Key-value parameters associated with the error message, used for templated errors.
Show child attributes
Show child attributes
Response payload. Empty when the request fails.
Show child attributes
Show child attributes