Direct Auth

post

https://securelink-staging.valorpaytech.com:443/api/v1/auth

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…

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

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

cardnumber

string

required

Defaults to 4111111111111111

Customer card number. Must contain 15 to 19 digits.

expirydate

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

cvv

int32

Defaults to 999

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

cardholdername

string

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

invoicenumber

string

required

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

Set 0 for transactions processed through a traditional MID with no custom fee. Set 1 for transactions processed through a cash discounting MID with a custom fee.

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)

productIds

array of objects

productIds

discount_id

string

Unique identifier of the product discount.

avs

string

Defaults to 0

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

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

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.

tip

double

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

shouldVaultCard

string

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

binBasedSurchargeCalc

string

If the value is set to 1, the custom fee will be calculated based on the card fee configured in the Portal settings.

Responses

Language

Loading…

Response

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

application/json

200200

400400