Direct Sale API (L2/L3)

Level 2: The PO Number is mandatory and must be included in the request.
Level 3: All Level 3–specific fields listed in the API description are mandatory and must be included in the request.

Body Params
string
required
Defaults to h6tSvf0Cz7fSB86B44bkLEplS15AsWYo

Merchant APP ID (Alphanumeric - Length of 32 chars and special chars $@%#)

string
required
Defaults to zOKj0LUOiW4L9jFRrMbMiJQ5KxQEpSMm

Merchant APP KEY (Alphanumeric - Length of 32 chars and special chars $@%#)

string
required
Defaults to 2412333540

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

string
required
Defaults to sale

sale or auth ('sale' - Amount of the purchase will be deducted from the cardholder's bank account and 'auth' - it will be held (authorized) for a certain period of time/days)

string
required
Defaults to 10

Transaction amount - Maximum amount $99,999.99 (Ex: 0.1 to 99,999.99). A request should not be sent when the amount is 0. The amount must be greater than zero

string

Tax amount - Currency $ (Eg. 00.00)

string
required
Defaults to 4111111111111111

Customer card number 15 to 19 digits

string
required
Defaults to 1236

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"))

string
Defaults to 999

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

string

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

string
required
Defaults to inv0001

Invoicenumber is required if we pass order_details

string
Defaults to king size bed 10x12

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

string
Defaults to 1.02

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

string
required
Defaults to 0

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

string

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

string
Defaults to 2 Jericho Plz

Address should be max 100 chars - Alphanumeric

string
string
required
Defaults to US

Shipping country should be mention default set us US

string
Defaults to 50001

Zip code should be 5 digits (Numeric - Ex: 10001, 90002)

string

Customer email id - Varchar (Ex: [email protected], Max length of 50 chars)

order_details
array of objects
required
order_details*
string

Customer field must contain a maximum of 100 characters and may include only alphanumeric characters, #, and @.

additional_prompts
array of objects

Additional Inputs should be allowed max 25

additional_prompts
vaultPaymentInfo
object
string
required

The PO number must be provided to receive the Level 2 benefit (Alphanumeric Max 25 chars).

string
required

The Customer VAT should be maximum 13-character alphanumeric value (Level 3 benefit).

string
required

Freight amount - Currency $ (Eg. 00.00) (Level 3 benefit).

string
required

Freight tax amount - Currency $ (Eg. 00.00) (Level 3 benefit).

string
required

The postal code should be maximum 10 numeric value (Level 3 benefit).

string
required

The VAT invoice should be Maximum 15-character alphanumeric value (Level 3 benefit).

string
required

Duty amount - Currency $ (Eg. 00.00) (Level 3 benefit).

Responses

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json