Verify
Verify a payment method to ensure it can be used to create a Transaction at a later time.
Authorization
bearerAuth Access token from POST /accesstoken, sent as Authorization: Bearer <token>.
In: header
Header Parameters
Integrator generated value submitted in the request header that is checked to ensure the same value has not been seen in the last 24 hours. It is used to ensure idempotency is maintained with this action.
1 <= length <= 50The version of the API to execute the request.
1 <= length <= 50"2021-03-22"Request Body
application/json
A meaningful label for the merchant account set by Global Payments.
1 <= length <= 50A unique identifier for the merchant account set by Global Payments.
1 <= length <= 50Describes whether the transaction was processed in a face to face(CP) scenario or a Customer Not Present (CNP) scenario.
CP- A Customer Present transaction is when the payer and the merchant are in direct face to face contact when exchanging payment method information to fulfill a transaction. e.g. in a store and paying at the counter that is attended by a clerkCNP- A Customer NOT Present transaction is when the payer and the merchant are not together when exchanging payment method information to fulfill a transaction. e.g. a transaction executed from a merchant's website or over the phone
Value in
- "CP"
- "CNP"
The currency of the amount in ISO-4217(alpha-3).
3 <= length <= 3Value in
- "USD"
- "EUR"
- "GBP"
- "CAD"
- "CHF"
- "HKD"
- "SGD"
- "MOP etc."
Merchant defined field to reference the transaction.
8 <= length <= 50The country in ISO-3166-1(alpha-2 code) format.
Indicates whether the Merchant or the Payer initiated the creation of a transaction.
PAYER- The transaction was initiated by the customer who is paying the merchant.MERCHANT- The transaction was initiated by the merchant, who is getting paid by the payer.
1 <= length <= 50Value in
- "PAYER"
- "MERCHANT"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/verifications" \ -H "X-GP-Version: 2021-03-22" \ -H "Content-Type: application/json" \ -d '{ "account_name": "Transaction_Processing", "channel": "CNP", "currency": "USD", "reference": "MY_TRANS_REF_12345", "country": "US", "payment_method": { "name": "James Mason", "entry_mode": "ECOM", "card": { "number": "4263970000005262", "expiry_month": "05", "expiry_year": "30" } } }'{ "id": "VER_NBTL2Kihd8Z878oaF764RQECrizXMK", "time_created": "2026-03-03T20:22:32.503Z", "type": "VERIFICATION", "status": "VERIFIED", "channel": "CP", "country": "CA", "merchant_id": "MER_c5d37eaf0e3841e083c232b2318af55c", "merchant_name": "Sandbox_Merchant_4", "account_id": "TRA_27c901760029495f813afbb0dab197ef", "account_name": "transaction_processing", "reference": "99439631", "payment_method": { "result": "00", "message": "APPROVAL", "entry_mode": "MANUAL", "card": { "funding": "PREPAID", "brand": "VISA", "masked_number_last4": "XXXXXXXXXXXX6781", "authcode": "VI0000", "brand_reference": "006062400006552", "available_balance": "-123456789011" } }, "batch_id": "", "action": { "id": "ACT_NBTL2Kihd8Z878oaF764RQECrizXMK", "type": "VERIFY", "time_created": "2026-03-03T20:22:32.503Z", "result_code": "SUCCESS", "app_id": "T6og1tbECpHFeO104qUM383oq5bOJ12r", "app_name": "Postman_Collection_Test" }}