v1
latestOpenAPI 3.1.02026-08-0425501.2 MBAdd Subscription
Request body
Merchant APP ID (Alphanumeric - Length of 32 chars)
Merchant APP KEY (Alphanumeric - Length of 32 chars and special chars $@%#)
EPI is an end point identifier, Identify the device on valor infrastructure, it's a 10 digit number starts with 2
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
Additional fee of surcharge amount - Currency $ (Eg: 10.00)
Tax amount - Currency $ (Eg. 00.00)
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
To accepts 0-Weekly or 1-Bi-Weekly, 2-Monthly, 3-Quarterly, 4-Annually, 5-Daily and 6- Run at
Either 0 or 1 (1 - Card validation only (no charge). 0 - Immediate payment for the current billing cycle.
Name of the cardholder - Alphabet (Max length of 25 chars)
It should be 25 chars
Description of the product max 50 chars
Invoice number is a unique number assigned (Alphanumeric - Max length of 12 chars)
Street number - Number with hyphen (Ex: 1-95)
Street name - Alphanumeric (Length of 50 chars)
Shipping customer name - Alphabet (Max length of 25 chars)
Street unit (Ex. block, apartment) - Max length of 25 chars
Zip code should be 5 digits (Numeric - Ex: 10001, 90002)
City should be allowed max 50 chars of string (Ex: New York, San Francisco)
Customer Name - Alphabet (Max length of max 25 chars)
State 2 chars of capital (Ex: New York - NY, California - CA)
Street number - Number with hyphen (Ex: 1-95)
Street unit (Ex. block, apartment) - Max length of 25 chars
Street name - Alphanumeric (Length of 50 chars)
Zip code should be 5 digits (Numeric - Ex: 10001, 90002)
City should be allowed max 50 chars of string (Ex: New York, San Francisco)
State 2 chars of capital (Ex: New York - NY, California - CA)
Subscription start payment date accepted expiry YYYYMMDD
Customer phone number- 10 digit Numeric (Ex: 5247896523)
Customer email id - Varchar (Ex: test@domain.com, Max length of 50 chars)
Months or Week based on recurring_type. If never expire to pass "never_expired"
If recurring type 0-Weekly or 1-Bi-Weekly this should be any value from 0 to 6 else if recurring type 2, 3, 4, 5, 6 it accept any value from 1 to 30 Days in month
Failure Notification set as 0 or 1
For installment transactions, the payment type will be sent as 2
If you want to check for duplicate transactions, set duplicate_transaction_check to 1 and is_validate_card to 0.
Response
200