Verification
Last Updated:What's in this article?
Verifies that a card number, and optionally AVS and/or CVV2 data, is valid.
Only applicable to credit card authorizations. This transaction will not be saved in the gateway.
This request requires the Auth Only permission on the source key.
For Amex cards, if a CVV2 is sent and an Amex processor is available, it will be used, regardless of processor logic. If the only CC processor is a Fiserv (FirstData) platform, the CVV2 might be left out of the verification request sent to the processor, since their platforms do not support CVV2 in all situations.
AUTHORIZATIONS:
REQUEST BODY SCHEMA: application/json
| card required | Card number |
| expiry_month required | Card expiration month. If using a card token, send any valid month. |
| expiry_year required | Card expiration year. If using a card token, send any valid year. |
| avs_address | Billing address for the card. |
| avs_zip | Billing zip code for the card. While not required, this field should be populated for fraud prevention and to obtain the best rate for E-commerce credit card transactions. |
| name | Name on card |
| transaction_details | object (BaseTransactionDetails) Additional optional transaction details. |
| save_card | If set to true and the transaction has been approved, the system will issue a token for future use. |
| transaction_flags | object (TransactionFlags) These flags provide more details about the transaction. Although they are optional, is recommended they be sent, to ensure optimal approval rates. |
| cvv2 | string Security code, otherwise known as CVC or CID. For Amex, this is the 4 digit code on the front of the card. For other card brands, this is the 3 digit code on the back. While not required, this field should be populated for fraud prevention. |
| 3d_secure | object Data for 3D-Secure (Verified by Visa, MasterCard SecureCode, Amex SafeKey, Discover ProtectBuy). These values come from a 3rd party 3D-Secure provider. Note: 3D-Secure is only applicable for e-Commerce merchants. Only 3D-Secure version 2 is supported. |