{"id":904,"date":"2025-06-08T16:53:58","date_gmt":"2025-06-08T16:53:58","guid":{"rendered":"https:\/\/lddpay.com\/?post_type=docs&p=904"},"modified":"2025-06-08T16:53:58","modified_gmt":"2025-06-08T16:53:58","password":"","slug":"tokens","status":"publish","type":"docs","link":"https:\/\/lddpay.com\/zh\/docs\/tokens\/","title":{"rendered":"Tokens"},"content":{"rendered":"

<\/a>Request a token<\/h2>\n\n\n\n

Exchange card details for a reference token that can be used later to request a card payment. Tokens are single use and expire after 15 minutes.<\/p>\n\n\n\n

Authorizations<\/summary>\n

bearer<\/em><\/p>\n\n\n\n

<\/h5>\n\n\n\n
HTTP: bearer<\/h5>\n\n\n\n

HTTP Authorization Scheme: <\/strong>bearer<\/code><\/p>\n\n\n\n

Bearer format: <\/strong>JWT<\/code><\/p>\n<\/details>\n\n\n\n

header Parameters<\/h5>\n\n\n\n
Authorizationrequired<\/td>stringBearer token (API Public Key).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Request Body schema: application\/json<\/h5>\n\n\n\n

Request body for creating a card token.<\/p>\n\n\n\n

type required<\/td>stringThe type of card details to be tokenized.<\/td><\/tr>
number required<\/td>stringThe card number.<\/td><\/tr>
expiry_month required<\/td>number [ 1 .. 12 ] The expiry month of the card.<\/td><\/tr>
expiry_year required<\/td>numberThe expiry year of the card (4 digits).<\/td><\/tr>
name<\/td>stringThe cardholder’s name.<\/td><\/tr>
cvv<\/td>stringThe card verification value\/code. 3 digits, except for American Express (4 digits).<\/td><\/tr>
billing_address<\/td>objectThe payment source owner’s billing address.<\/td><\/tr>
phone<\/td>objectThe payment source owner’s phone number.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Responses<\/h5>\n\n\n\n
201 Reference token created successfully<\/summary>\n
Response Schema: application\/json<\/h5>\n\n\n\n
expiry_month required<\/td>numberThe expiry month.<\/td><\/tr>
expiry_year required<\/td>numberThe expiry year.<\/td><\/tr>
last4 required<\/td>stringThe last four digits of the card number.<\/td><\/tr>
bin required<\/td>stringThe card issuer BIN.<\/td><\/tr>
type required<\/td>stringThe type of card details to be tokenized.<\/td><\/tr>
token required<\/td>stringThe reference token.<\/td><\/tr>
expires_onrequired<\/td>string <date-time> The date\/time the token will expire.<\/td><\/tr>
scheme<\/td>stringThe card scheme.<\/td><\/tr>
scheme_local<\/td>stringThe local co-branded card scheme.<\/td><\/tr>
card_type<\/td>string Enum:”CREDIT””DEBIT””PREPAID””CHARGE””DEFERRED DEBIT”The card type.<\/td><\/tr>
card_category<\/td>string Enum:”CONSUMER””COMMERCIAL”The card category.<\/td><\/tr>
issuer<\/td>stringThe name of the card issuer.<\/td><\/tr>
issuer_country<\/td>string = 2 characters The card issuer country ISO-2 code.<\/td><\/tr>
product_id<\/td>stringThe issuer\/card scheme product identifier.<\/td><\/tr>
product_type<\/td>stringThe issuer\/card scheme product type.<\/td><\/tr>
billing_address<\/td>objectThe payment source owner’s billing address.<\/td><\/tr>
phone<\/td>objectThe payment source owner’s phone number.<\/td><\/tr>
name<\/td>stringThe cardholder’s name.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n

401 Unauthorized<\/p>\n\n\n\n

422 Invalid data was sent.<\/summary>\n
Response Schema: application\/json<\/h5>\n\n\n\n
request_id required<\/td>stringThe unique request identifier.<\/td><\/tr>
error_type required<\/td>stringThe error type.<\/td><\/tr>
error_codes required<\/td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>","protected":false},"excerpt":{"rendered":"

Request a token Exchange card details for a reference token that can be used later to request a card payment. […]<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"doc_category":[122],"doc_tag":[],"year_month":"2026-04","word_count":275,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"author_nicename":"admin","author_url":"https:\/\/lddpay.com\/zh\/author\/admin\/"},"doc_category_info":[{"term_name":"Temp Solution","term_url":"https:\/\/lddpay.com\/zh\/docs-category\/temp-solution\/"}],"doc_tag_info":[],"author_list":[{"ID":"3","user_login":"jony","display_name":"jony","id":"3"},{"ID":"2","user_login":"Merchantlogin","display_name":"Merchantlogin","id":"2"},{"ID":"1","user_login":"w2863431","display_name":"admin","id":"1"}],"_links":{"self":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/904"}],"collection":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/comments?post=904"}],"version-history":[{"count":1,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/904\/revisions"}],"predecessor-version":[{"id":905,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/904\/revisions\/905"}],"wp:attachment":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/media?parent=904"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_category?post=904"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_tag?post=904"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}