Payment Window Integration API
Last updated
Last updated
Payment Window integration uses a set of standard basic parameters which makes the integrations steps easier, even when you use multiple payment modes.
For payment integration request, all communication with Faspay e-Payment must be accomplished through web browser. Backend submission using socket interface is not allowed as the payment process flow involve browser submission and redirection. Merchant do not necessary to have secure SSL certificates installed as all sensitive payment related information are entered only at Faspay e-Payment web pages. Merchants using this integration option should not collect and store any sensitive information such as credit card number etc.
Use the following URL to submit to our payment window interface through HTML FORM POST method:
The above URL is for tokenization transaction processing.
Following are the additional parameters you should include in your payment request:
pymt_ind
Varchar(20)
M
Specify the payment indicator to be used for tokenization transaction. The payment indicator is used as the key identifier to set certain indication. For tokenization you can fill with : PYMT_IND = “tokenization” Nb) : for all condition, registration, payment or update card always use PYMT_IND = tokenization
pymt_criteria
Varchar(20)
C
Specify the payment criteria to be used, together with the parameter PYMT_IND. This criteria will be set one the payment indicator had been defined. PYMT_CRITERIA = “registration” Is for registration payment tokenization, PYMT_CRITERIA = “payment” Is for transaction after registration, or update / add new card.
pymt_token
Varchar(40)
C
This field for data tokens, for transaction registration this filed will be blank (null), but for transaction payment (after registration transaction) fill this field with token from response payment on registration.
Sample token :
“47271385-94F5-410A-9890-09CBB77F2A66”
You can store on your database formapped with a user ID that is registered in the merchant system.
Credit Card Payment Response:
Following are the standard parameters that the payment result will pass back as a response for credit card payments. Transaction request that has insufficient parameters or incorrect values, will be rejected by Faspay e-Payment and not stored in the system. Same as standard transactions, tokenization transactions will receive parameters like TXN_STATUS and others, for tokenization if the transaction succeeds Faspay will send the token on the return URL and callback merchant. Additional response param for tokenization :
pymt_token
Varchar (40)
C
Faspay will send the token ID if the transaction success by return URL and Callback merchant.
Sample token :
“47271385-94F5-410A-9890-09CBB77F2A66”