API Reference

Direct Sale API (L2/L3)

post
https://securelink-staging.valorpaytech.com:4430/?directsalel2l3

Direct sale with the card number. For AVS verification from the API, the fields sent should be based on the portal settings. If the setting is configured as “Address Only,” then only the address details should be sent in the address1 field. If the setting is configured as “ZIP Only,” then only the zip value should be sent in the zip property.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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
object
required
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).

int32

Either 0 or 1.

string
Defaults to 0

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

Responses

Updated 1 day ago

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

Updated 1 day ago