Check

Search…

Check

Use this API to validate an existing Token against the VISA, MasterCard and AMEX network at any time.

Using the card check API provides you with a simple and effective way against fraud.
Thereby we run a zero amount call against the Visa, MasterCard and AMEX network to check if the card is still valid, not stolen or expired. The authorization request does not appear on the customer statement but still gives you the ability to test the validity of a stored credit card.
The service requires HTTP basic authentication. The required credentials can be found in our dashboard. Please refer to API authentication data for more information.
1. Activate credit card check feature
Please contact PCI Proxy team to activate the credit card check feature on your PCI Proxy account.
2. Call the validate API
post
https://api.sandbox.datatrans.com
/v1/transactions/validate
Validate method
In test mode, only test credit cards are allowed.
Examples
Request
Response Success
Response error 
1
curl -X POST \
2
  https://api.sandbox.datatrans.com/v1/transactions/validate \
3
  -H 'Authorization: Basic MTAwMDAwMTExMTpwWUU4bFE2TlBiM2thRXpR' \
4
  -H 'Content-Type: application/json; charset=UTF-8' \
5
  -d '{
6
    "currency": "EUR",
7
    "refno": "vptJ07xyr",
8
    "card": {
9
        "alias": "AAABcHxr-sDssdexyrAAAfyXWIgaAF40",
10
        "expiryMonth": "12",
11
        "expiryYear": "21"
12
    }
13
}'
Copied!
1
{
2
  "transactionId": "191016104224286267",
3
  "acquirerAuthorizationCode": "104224",
4
  "card": {
5
    "masked": "424242xxxxxx4242"
6
  }
7
}
Copied!
1
{
2
  "error": {
3
    "code": "EXPIRED_CARD",
4
    "message": "expired card"
5
  },
6
  "transactionId": "191016104534077141",
7
}
Copied!
Error table
UNKNOWN_ERROR UNAUTHORIZED INVALID_JSON_PAYLOAD UNRECOGNIZED_PROPERTY INVALID_PROPERTY CLIENT_ERROR SERVER_ERROR INVALID_TRANSACTION_STATUS TRANSACTION_NOT_FOUND EXPIRED_CARD INVALID_CARD BLOCKED_CARD UNSUPPORTED_CARD INVALID_ALIAS INVALID_CVV DUPLICATE_REFNO DECLINED SOFT_DECLINED INVALID_SIGN BLOCKED_BY_VELOCITY_CHECKER THIRD_PARTY_ERROR REFERRAL INVALID_SETUP

Show

Authorize/Settle

Last modified 4d ago

Copy link

Contents

1. Activate credit card check feature

2. Call the validate API