Ecommerce Sale API

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

This page will help you get started with Ecommerce API.

Body Params

appid

string

required

Defaults to QWizN3u0poN5Wrb4GaKAqAp63EvKkZRK

Merchant APP ID (Alphanumeric - Length of 32 chars)

appkey

string

required

Defaults to lo196Pj5Vw1pScye3iq8z2WdSOTcNGVD

Merchant APP Key (Alphanumeric - Length of 32 chars)

epi

string

required

Defaults to 2319923425

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 84.00

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

phone

string

Defaults to 9677193050

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

string

Defaults to jhonsmith@valorpaytech.com

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

uid

string

A unique id of the request, A client can send any number of 10 digit

tax_amount

string

Defaults to 0

Tax amount - Currency $ (Eg. 00.00)

surchargeIndicator

int32

required

Defaults to 1

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

surchargeAmount

string

Defaults to 3.36

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

address1

string

required

Defaults to 8320

Shipping address should be max 100 chars - Alphanumeric

address2

string

Defaults to 2nd street

Billing address should be max 100 chars - Alphanumeric

city

string

required

Defaults to New York

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

state

string

required

Defaults to CO

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

zip

string

required

Defaults to 85284

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

billing_country

string

required

Defaults to US

Billing country should be mention default set us US

shipping_country

string

required

Defaults to US

Shipping country should be mention default set us US

cardnumber

string

required

Defaults to 4111111111111111

Customer card number 15 to 19 digits

status

string

required

Defaults to Y

Set the status if Y or N

cvv

string

required

Defaults to 999

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

cardholdername

string

required

Defaults to Michel Nicholos

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

expirydate

date

required

Defaults to 1224

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

Responses

Language


xxxxxxxxxx
30
1
curl --request POST \
2
     --url 'https://securelink-staging.valorpaytech.com:4430/?saleapi=' \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "appid": "QWizN3u0poN5Wrb4GaKAqAp63EvKkZRK",
8
  "appkey": "lo196Pj5Vw1pScye3iq8z2WdSOTcNGVD",
9
  "epi": "2319923425",
10
  "txn_type": "sale",
11
  "amount": "84.00",
12
  "phone": "9677193050",
13
  "email": "jhonsmith@valorpaytech.com",
14
  "tax_amount": "0",
15
  "surchargeIndicator": 1,
16
  "surchargeAmount": "3.36",
17
  "address1": "8320",
18
  "address2": "2nd street",
19
  "city": "New York",
20
  "state": "CO",
21
  "zip": "85284",
22
  "billing_country": "US",
23
  "shipping_country": "US",
24
  "cardnumber": "4111111111111111",
25
  "status": "Y",
26
  "cvv": "999",
27
  "cardholdername": "Michel Nicholos",
28
  "expirydate": "1224"
29
}

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

application/json

200200

400400