v1
latestOpenAPI 3.1.02026-08-0425501.2 MBRefund API
Query parameters
Merchant APP ID (Alphanumeric - Length of 32 chars)
Merchant APP Key (Alphanumeric - Length of 32 chars)
The unique id refers to a particular store of the merchant
Set the message type as 'refund'
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
Customer card number 15 to 19 digits
Card expiry date, Accepted expiry MMYY & MM/YY
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
Currency $(Eg. 00.00) - Food amount should be less than to transaction amount
Tax amount - Currency $ (Eg. 00.00)
City tax amount - Currency $ (Eg. 00.00)
Reduced tax amount - Currency $ (Eg. 00.00)
A unique id of the request, A client can send any number of 10 digit
Additional fee of surcharge amount - Currency $ (Eg: 10.00)
Card Verification Value should be 3 or 4 digits (Ex: 999, 9997)
To identify the card type to check Credit or Debit
To remove the surcharge fee set value 0 else set 1
Name of the cardholder - Alphabet (Max length of 25 chars)
Shipping address customer name - Alphabet (Max length of 25 chars)
Billing address customer name - Alphabet (Max length of 25 chars)
Customer unique recursive payment id (subscription id) (Numeric - Max length of 11 chars)
Address verification service (zip, street address - Numeric length of one chars)
Customer phone number- 10 digit Numeric (Ex: 5247896523)
Customer email id - Varchar (Ex: test@domain.com, Max length of 50 chars)
Customer user name (Alphanumeric length of 25 chars)
Shipping address street number - Number with hyphen (Ex: 1-95)
Shipping address street name - Alphanumeric (Length of 50 chars)
Shipping address unit (Ex. block, apartment) - Max length of 25 chars
Shipping address city should be allowed max 50 chars of string (Ex: New York, San Francisco)
Shipping address state 2 chars of capital (Ex: New York - NY, California - CA)
Shipping address zip code should be 5 digits (Numeric - Ex: 10001, 90002)
Billing address street number - Number with hyphen (Ex: 1-95)
Billing address street name - Alphanumeric (Length of 50 chars)
Billing address unit (Ex. block, apartment) - Max length of 25 chars
Billing address city should be allowed max 50 chars of string (Ex: New York, San Francisco)
Billing address state 2 chars of capital (Ex: New York - NY, California - CA)
Billing address zip code should be 5 digits (Numeric - Ex: 10001, 90002)
Transaction order id for sale and auth (Length of max 11 chars)
Invoice number is a unique number assigned (Alphanumeric - Max length of 12 chars)
Line item against created dataset id (Numeric -Max length of 20 chars, Ex: 364, 370 )
Add the order description - Optional (Alphanumeric - Max length of 50 chars)
Validate the card default set as 1
It is the userid of the merchant to be updated
2FA request uuid (Max length of 50 chars)
Direct refund OTP (Ex: 500654, Max length of 6 chars)
Refund OTP API key
Refund OTP APP Id
Card token, received from sale or tokenization use it only
Response
200
Example response
{
"error_no": "S00",
"error_code": "00",
"amount": "100.00",
"msg": "APPROVED",
"desc": " NO MATCH ",
"epi": "2319914861",
"channel": "VT",
"rrn": "328911501243",
"txnid": "5227750"
}