Sale API

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

Direct sale with the card number

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)

token

string

required

Defaults to 3D97D58D65F905E67622E7E6D98D0D5BDA37842A

Card token can be generated from Create Card Token

amount

double

required

Defaults to 5

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

ecomm_channel

string

Defaults to passagejs

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 - Max length of 12 chars)

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

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

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.

tax_amount

string

Defaults to 1.02

Tax amount - Currency $ (Eg. 00.00)

order_details

object

productIds

array of objects

productIds

discount_id

string

Defaults to 1576

Product discount id

Responses

Language


xxxxxxxxxx
31
1
curl --request POST \
2
     --url 'https://securelink-staging.valorpaytech.com:4430/?sale (COPY)=' \
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
  "token": "3D97D58D65F905E67622E7E6D98D0D5BDA37842A",
12
  "amount": 5,
13
  "ecomm_channel": "passagejs",
14
  "cardholdername": "Michael Jordan",
15
  "invoicenumber": "inv0001",
16
  "orderdescription": "king size bed 10x12",
17
  "surchargeAmount": 10.2,
18
  "surchargeIndicator": 1,
19
  "address1": "2 Jericho Plz",
20
  "city": "Jericho",
21
  "state": "NY",
22
  "shipping_country": "US",
23
  "billing_country": "US",
24
  "zip": "50001",
25
  "customer_email": "0",
26
  "customer_sms": "1",
27
  "merchant_email": "0",
28
  "tax_amount": "1.02",
29
  "discount_id": "1576"

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

application/json

200200

400400