Sale API

post https://vt-staging.valorpaytech.com:4430?/?saleapi

Test Cards

CardType	PAN Number	Expiration Date	CVV
Visa	4012000098765439	1224	999
MasterCard	5499740000000057	1224	998
MasterCard	2223000048400011	1224	998
Amex	371449635392376	1224	9997
Discover	6011000993026909	1224	996
Diners	30551555151618	1224	996
JCB	3530142019945859	1224	996

Query Params

app_id

string

required

Defaults to WaJeJErcv5xpqZa2UZz6LZod5MSyyfJw

Merchant APP ID (Alphanumeric - Length of 32 chars)

auth_key

string

required

Defaults to 53PWdki5U0PGSVhRnVoFsfVSbuDutsA8

Merchant APP Key (Alphanumeric - Length of 32 chars)

epi

string

required

Defaults to 2203082193

EPI is an end point identifier, Identify the device on valor infrastructure, it's a 10 digit number starts with 2

mtype

string

required

Defaults to 0200

Message type for 0200 is sale transaction request

uid

string

A unique id of the request, A client can send any number of 10 digit

amount

double

required

Defaults to 11.11

Transaction amount - Maximum amount $99,999.99 (Ex: 0.1 to 99,999.99)

pan

int32

required

Defaults to 4111111111111111

Customer card number 15 to 19 digits

expiry_date

date

required

Defaults to 1224

Card expiry date, Accepted expiry MMYY & MM/YY (The expiration date must be exactly 4 characters long, consisting of a 2-digit month (with a leading zero if necessary) followed by a 2-digit year (e.g., "0526"))

surchargeIndicator

int32

required

Defaults to 1

The value '0' represents a transaction being ran on the traditional MID with no custom fee added, while '1' represents a transaction being ran on the cash discounting MID with the custom fee added

food_amount

double

Defaults to 0

Currency $(Eg. 00.00) - Food amount should be less than to transaction amount

tax

double

Defaults to 0.44

Tax amount - Currency $ (Eg. 00.00)

city_tax

double

Defaults to 0

Tax amount - Currency $ (Eg. 00.00)

reduced_tax

double

Defaults to 0

City tax amount - Currency $ (Eg. 00.00)

custom_fee

double

Defaults to 0.02

Additional fee of surcharge amount - Currency $ (Eg: 10.00)

cvv

int32

Defaults to 999

Card Verification Value should be 3 or 4 digits (Ex: 999, 9997)

surchargeRemoved

int32

Defaults to 0

To remove the surcharge fee set value 0 else set 1

card_holder_name

string

Name of the cardholder - Alphabet (Max length of 25 chars)

s_customerName

string

Shipping address customer name - Alphabet (Max length of 25 chars)

b_customerName

string

Billing address customer name - Alphabet (Max length of 25 chars)

recursivePaymentId

string

Customer unique recursive payment id (subscription id) (Numeric - Max length of 11 chars)

avs

string

Defaults to 1

Address verification service (zip, street address - Numeric length of one chars)

recursivePayment

boolean

Defaults to false

Is recursive payment set as true or false (Boolean)

phone

int32

Customer phone number- 10 digit Numeric (Ex: 5247896523)

string

Customer email id - Varchar (Ex: test@domain.com, Max length of 50 chars)

username

string

Customer user name (Alphanumeric length of 25 chars)

s_street_no

string

Shipping address street number - Number with hyphen (Ex: 1-95)

s_street_name

string

Shipping address street name - Alphanumeric (Length of 50 chars)

s_unit

string

Shipping address unit (Ex. block, apartment) - Max length of 25 chars

s_city

string

Shipping address city should be allowed max 50 chars of string (Ex: New York, San Francisco)

s_state

string

Shipping address state 2 chars of capital (Ex: New York - NY, California - CA)

s_zip

string

Shipping address zip code should be 5 digits (Numeric - Ex: 10001, 90002)

b_street_no

string

Billing address street number - Number with hyphen (Ex: 1-95)

b_street_name

string

Billing address street name - Alphanumeric (Length of 50 chars)

b_unit

string

Billing address unit (Ex. block, apartment) - Max length of 25 chars

b_city

string

Billing address city should be allowed max 50 chars of string (Ex: New York, San Francisco)

b_state

string

Billing address state 2 chars of capital (Ex: New York - NY, California - CA)

b_zip

string

Billing address zip code should be 5 digits (Numeric - Ex: 10001, 90002)

orderId

int32

Transaction order id for sale and auth (Length of max 11 chars)

invoicenumber

int32

Invoice number is a unique number assigned (Alphanumeric - Max length of 12 chars)

dataset_id

int32

Line item against created dataset id (Numeric -Max length of 20 chars, Ex: 364, 370 )

orderdescription

string

Add the order description - Optional (Alphanumeric - Max length of 50 chars)

validateCard

string

Defaults to 0

Validate the card default set as 1

userid

int32

Customer user id - Numeric max length of 11 chars

Responses

Language


xxxxxxxxxx
1
curl --request POST \
2
     --url 'https://vt-staging.valorpaytech.com:4430/?app_id=WaJeJErcv5xpqZa2UZz6LZod5MSyyfJw&auth_key=53PWdki5U0PGSVhRnVoFsfVSbuDutsA8&epi=2203082193&mtype=0200&amount=11.11&pan=4111111111111111&expiry_date=1224&surchargeIndicator=1&food_amount=0&tax=0.44&city_tax=0&reduced_tax=0&custom_fee=0.02&cvv=999&surchargeRemoved=0&avs=1&recursivePayment=false&validateCard=0&/?saleapi=' \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Test Cards

200200

400400