Direct Sale / Auth

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

Direct sale with the card number

Body Params

appid

string

required

Defaults to h6tSvf0Cz7fSB86B44bkLEplS15AsWYo

Merchant APP ID (Alphanumeric - Length of 32 chars)

appkey

string

required

Defaults to zOKj0LUOiW4L9jFRrMbMiJQ5KxQEpSMm

Merchant APP Key (Alphanumeric - Length of 32 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

double

required

Defaults to 5

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

tax_amount

string

Tax amount - Currency $ (Eg. 00.00)

cardnumber

string

required

Defaults to 4111111111111111

Customer card number 15 to 19 digits

expirydate

date

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

Defaults to Michael Jordan

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

invoicenumber

string

Defaults to inv0001

Invoice number is a unique number assigned (Alphanumeric)

orderdescription

string

Defaults to king size bed 10x12

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

surchargeAmount

double

Defaults to 10.2

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

surchargeIndicator

int32

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

int32

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

address1

string

Defaults to 2 Jericho Plz

Shipping address should be max 100 chars - Alphanumeric

address2

string

Billing address should be max 100 chars - Alphanumeric

city

string

Defaults to Jericho

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

state

string

Defaults to NY

State 2 chars of capital (Ex: New York - NY, California - CA)

shipping_country

string

required

Defaults to US

Shipping country should be mention default set us US

billing_country

string

Defaults to US

Billing country should be mention default set us US

zip

string

Defaults to 50001

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

string

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

customer_email

string

Defaults to 0

Optional - This property is designed to control the sending of emails to customers, where a value of 0 indicates that the mail was not sent, and a value of 1 indicates that the mail will be sent.

customer_sms

string

Defaults to 1

Optional - This property is designed to control the sending of SMS to customers, where a value of 0 indicates that the SMS was not sent, and a value of 1 indicates that the SMS will be sent.

merchant_email

string

Defaults to 0

Optional - This property is designed to control the sending of emails to merchants, where a value of 0 indicates that the mail was not sent, and a value of 1 indicates that the mail will be sent.

productIds

array of objects

productIds

discount_id

string

Defaults to 1576

Product discount id

avs

string

Defaults to 0

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

Responses

Language


xxxxxxxxxx
32
1
curl --request POST \
2
     --url 'https://securelink-staging.valorpaytech.com:4430/?sale=' \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "appid": "h6tSvf0Cz7fSB86B44bkLEplS15AsWYo",
8
  "appkey": "zOKj0LUOiW4L9jFRrMbMiJQ5KxQEpSMm",
9
  "epi": "2412333540",
10
  "txn_type": "sale",
11
  "amount": 5,
12
  "cardnumber": "4111111111111111",
13
  "expirydate": "1236",
14
  "cvv": 999,
15
  "cardholdername": "Michael Jordan",
16
  "invoicenumber": "inv0001",
17
  "orderdescription": "king size bed 10x12",
18
  "surchargeAmount": 10.2,
19
  "surchargeIndicator": 0,
20
  "address1": "2 Jericho Plz",
21
  "city": "Jericho",
22
  "state": "NY",
23
  "shipping_country": "US",
24
  "billing_country": "US",
25
  "zip": "50001",
26
  "customer_email": "0",
27
  "customer_sms": "1",
28
  "merchant_email": "0",
29
  "discount_id": "1576",

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

application/json

200200

400400