Card verification - Regional API GetNet

Verify a Card

This endpoint allows you to validate a credit card using its tokenized representation. It confirms that the card is valid, active, and not subject to restrictions such as being cancelled, blocked, or expired.

Usage Scenarios:
- Ensuring the card is valid before storing it in the vault.
- Verifying a card prior to initiating a payment or subscription.
- Reducing transaction failures by detecting invalid or restricted cards early.

Notes:
- The request must include a tokenized card number, not raw card data.
- Card information such as brand, expiration, and CVV must match what was originally provided.
- A successful response includes a verification ID, authorization code, and transaction ID, which can be logged for traceability.

请求参数

Authorization

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.pre.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api-sbx.globalgetnet.com/authentication/oauth2/access_token

Scopes:

digital-platform:gateway-api-Read and write access

Body 参数application/json必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json; charset=utf-8

Card verification performed successfully.

Bodyapplication/json; charset=utf-8

示例

{
    "status": "VERIFIED",
    "verification_id": "ae267804-503c-4163-b1b1-f5da5120b74e",
    "authorization_code": "6964722471672911",
    "transaction_id": "1002217281190421"
}

🟠400

🟠401

🟠403

🟠404

🔴500