Skip to main content
POST
/
Tools
/
validate
Card Validation
curl --request POST \
  --url https://api.orchestrasolutions.com/Tools/validate \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "countryCode": "<string>",
  "clientIPAddress": "<string>",
  "city": "<string>",
  "stateProvince": "<string>"
}
'
{
  "riskLevel": "<string>",
  "description": "<string>",
  "cardBrand": "<string>",
  "cardType": "<string>",
  "cardCategory": "<string>",
  "issuerName": "<string>",
  "issuerCountry": "<string>",
  "countryByIP": "<string>",
  "countryFromBillingAddress": "<string>",
  "anonymousProxyUsed": true
}

Documentation Index

Fetch the complete documentation index at: https://developers.orchestrasolutions.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Please enter ApiKey into field

Query Parameters

​
iin
string
required

Card's BIN / IIN (the first 6 to 11 digits of the card number)

Pattern: \d{6,11}

Body

application/json

Payer billing details including IP address

Payer billing information including client IP address

​
countryCode
string
required

2 letter country code (ISO 3166-2)

Pattern: [A-Z]{2}
​
clientIPAddress
string
required

Client IP address

​
city
string | null

City

​
stateProvince
string | null

State or Province

Response

OK

Results for a card validation request including risk assessment

​
riskLevel
string

The risk level associated with this transaction (VeryLow, Low, High, VeryHigh)

​
description
string

A description of the risk that was identified for this transaction

​
cardBrand
string

The card brand (AMERICAN EXPRESS, VISA, MASTERCARD, JCB etc)

​
cardType
string

Type of card (CREDIT, DEBIT, etc.)

​
cardCategory
string

Card category (GIFT, PROPRIETARY, etc.)

​
issuerName
string

Name of card issuer (e.g. Bank of America)

​
issuerCountry
string

2 letter country code (ISO 3166-2) of the card issuer's country

​
countryByIP
string

2 letter country code (ISO 3166-2) of the country detected by the payer's IP address

​
countryFromBillingAddress
string

2 letter country code (ISO 3166-2) from the payer's billing address

​
anonymousProxyUsed
boolean

Whether the payer's IP address is from an anonymous proxy