Direct Sale Token (L2/L3)

post

https://securelink-staging.valorpaytech.com:443/?l2l3_token

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

Time	Status	User Agent
Retrieving recent requests…

Loading…

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

appid

string

required

Defaults to h6tSvf0Cz7fSB86B44bkLEplS15AsWYo

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

appkey

string

required

Defaults to zOKj0LUOiW4L9jFRrMbMiJQ5KxQEpSMm

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

epi

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

txn_type

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)

amount

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

tax_amount

string

Tax amount to be applied to the transaction. Must be provided as a currency amount in USD (e.g., 10.00).

token

string

required

Defaults to 9D583592578242B71F50ACCBE8532391F21CC305

Card token received from the Sale transaction. This token should be used only for the intended transaction flow.

cardholdername

string

Name of the cardholder. Must contain alphabetic characters only and have a maximum length of 40 characters.

invoicenumber

string

Defaults to inv0001

Invoice number field must contain a maximum of 100 characters and may include only alphanumeric characters. < and > are not allowed.

orderdescription

string

Defaults to king size bed 10x12

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

surchargeAmount

string

Defaults to 1.02

Additional surcharge fee amount to be applied to the transaction. Must be provided as a currency amount in USD (e.g., 10.00).

surchargeIndicator

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

phone

string

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

address1

string

Defaults to 2 Jericho Plz

Address should be max 100 chars - Alphanumeric

address

string

Address should be max 100 chars - Alphanumeric

shipping_country

string

required

Defaults to US

Shipping country should be mention default set us US

zip

string

Defaults to 50001

Must be a valid US ZIP code. Example: 55427

string

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

order_details

object

required

customer_name

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

po_number

string

required

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

customer_VAT

string

required

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

freight_amount

string

required

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

freight_tax_amount

string

required

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

ship_from_postal_code

string

required

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

VAT_invoice

string

required

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

duty_amount

string

required

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

duplicate_transaction_check

int32

Set to 1 to enable duplicate transaction checking based on the portal setting; set to 0 to disable it. For example, By Invoice Number declines transactions with the same invoice number in the same batch.

avs

string

Defaults to 0

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

tip

string

Tip amount to be applied to the transaction. Must be provided as a currency amount in USD (e.g., 10.00).

shouldVaultCard

string

Defaults to 0

If Priority processor, set the value to 1 to save the card to the processor; otherwise, set it to 0.

binBasedSurchargeCalc

int32

If the value is set to 1, the custom fee will be calculated based on the card fee configured in the Portal settings. This applies only to (Sale API) transactions.

Responses

Language

Loading…

Response

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

application/json

200200

400400