Invoice API Specifications


Introduction

We created a complete and detailed description of the Platform API. Here you can find all parameter descriptions.


Hosts

  • Test: https://staging..com/
  • Live: https://secure..com/

Security / Authentication

All requests must be sent over SSL (Secure Socket Layer).

The memberId and checksum are in need to authenticate every request against a particular terminal. And the POST parameters are used to send the authentication data. You can find more details about that in the Authentication Parameters.



Basic Payment

This reference list lists all the standard flow parameters to be send in request.

Parameter Description Format Required
amount Transaction request amount. Decimal format needs to be followed N13
[0-9]{1,10}\.[0-9]{2}
Yes
currency Transaction request currency A3
[a-zA-Z]{3}
Yes
paymentBrand It specifies the brand type of payment for the request AN32
[a-zA-Z0-9] {1,32}
Yes
paymentMode It specifies the mode of payment for the request AN32
[a-zA-Z0-9] {1,32}
Yes
merchantInvoiceId It specifies the ID of created merchant's invoice N10
[0-9]
Conditional
cancelReason It specifies the reason for cancelling invoice AN50
[A-Za-z0-9]
Yes
orderDescription It takes description of the order placed by customer AN255 Yes
invoiceId This reference number is provided by the merchant, When he wants to cancel, regenerate the invoice [0-9] Yes
merchantRedirectUrl This URL will receive the result of an asynchronous payment.
It must be sent URL encoded.
AN2048
([htpfs]{3,5}\\:?\\/\\/[\\w\\.\\:\\/]*\\??[a-zA-Z0-9]*)
Yes



Authentication

Authentication data is required in all requests. You can find a set of valid credentials in the tutorials. But if you want to set up another credential for your terminal please contact us.

Parameter Description Format Required
authentication.memberId Merchant's unique ID assigned by to authenticate a transaction request N10
[0-9]
Yes
authentication.checksum Cryptographic hash generated by MD5 as follows.
All the processes has different combination of
parameters to generate hash (all values
separated by pipe). Kindly refer sample
given in tutorial for each case
AN255
[a-zA-Z0-9]
Yes
authentication.terminalId Merchant's terminal ID provided by N4
[0-9]
No
authentication.authToken Unique token which will have to set while requesting every time for authentication. Merchant will get this authentication token by calling it's API> AN32
[a-zA-Z0-9]
Conditional


Customer

All the information about the customer like his name, contact details and identification documents are hold by the customer object.

Parameter Description Format Required
customer.givenName Name of the customer AN
[a-zA-Z0-9\\p{Space}\\,.:'"-=+)({}[]]+
No
customer.phone Phone number of the customer AN25
[a-zA-Z0-9\+-.]{6,25}
No
customer.telnocc Telephonic country code of the customer N4
[0-9]{1,4}
No
customer.email Email address of the customer AN
[A-Za-z0-9._%'-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}
No
customer.ip IP address of the customer AN255
(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)
No
customer.street Building name, and/or street name of the customer's address AN1000
[a-zA-Z0-9\\p{Space}\\,]+
Conditional
customer.city City of the customer's address AN50
[a-zA-Z0-9\\\\#&\\p{Space}\\p{L}\\p{M}\\-;.,~` ]{0,1000}
Conditional
customer.state State or region of the customer's address AN50
[\\ra-zA-Z0-9\\\\!@#$*%^&{}\\[\\]()_+\\p{L}\\p{M}\\-=,.~'` ]{0,1000}
Conditional
customer.postcode Zip code of the customer's address AN10
[A-Za-z0-9]{1,10}
Conditional
customer.country Country of the address AN3
[a-zA-Z0-9]{2,3}
Conditional


Response Parameters

Parameter Description Format Required
invoiceId It is necessary to identify the invoice request later. Later you can use this value as invoice ID. N10
[0-9]
Yes
amount Amount of the request N13
[0-9]{1,10}\.[0-9]{2}
Conditional
currency Currency of the request A3
[a-zA-Z\\p{Space}\\,]+
Conditional
result.code The unique response code that indicates the response status of the request. See the Response codes for more detailed information AN11
[0-9\.]{2,11}
Yes
result.description Response description of the response code AN255
[a-zA-Z0-9\\p{Space}\\,]+[a-zA-Z0-9\\p{Space}\\,]+
No
merchantTransactionId Unique transaction id which merchant gave while inquiring invoice AN255
[a-zA-Z0-9\\p{Space}\\,]+[a-zA-Z0-9\\p{Space}\\,]+
Yes
descriptor Descriptorof the invoice AN255
[a-zA-Z0-9\\p{Space}\\,]+[a-zA-Z0-9\\p{Space}\\,]+
Yes
email Email address of the customer AN255
Email format
No
Other The response can also contain each of the resources listed above, such as customer and shipping address n/a Conditional
timestamp Shows at what time the transaction has been placed date
yyyy-MM-dd hh:mm:ss
Yes
Copyright © 2015 - 2017. All Rights Reserved