PlatiOnline API - software developers
Contents
Plati Onine API
This document guides the new merchants to implement PlatiOnline system modules. The document provides step-by-step implementing instructions along with code examples. Document appendixes contain useful information such as definition tables for frequently used terms in card industry, error codes, state / country codes and other information.
How to do requests to Plati Online
All the calls to/from Plati Online system use SOAP method:
Every HTTP request between Plati Online system and the merchants servers are done using 3 XML tags:
Field name | Comments |
---|---|
F_LOGIN | this value is provided by Plati Online |
F_MESSAGE | this field contain an XML encrypted with AES algorithm. For every call you/we have to generate a new AES key an random 32 length alphanumeric |
F_CRYPT_MESSAGE | this field contain the AES key encrypted using the RSA algorithm |
Merchants security keys
Security keys are used to uniquely identify amount, currency and merchant who submits the transaction.
How to obtain security keys
Payment Authorization
The authorization process is split-ed into 3 steps:
Step | Comments |
---|---|
1. Validating the XML_Message validation schema | Merchants will create the authorization XML named XML_Message request based on Plati Online version.
XML_Message contain all the necessary information to initiate an authorization in the Plati Online system; |
2. Redirect URL | Once the XML_Message is successfully parsed the Plati Online system will echo an XML with the redirect URL. To continue transaction merchants have to send to the browser the URL HTTP Redirect. Plati Online system will load the card page. |
3. Authorization relay response Authorized/Declined/On Hold | Once the card is processed, the Plati Online system will send to merchant's server the response:
|
Payment Settle Request
After the authorization process you have 5 days to do the Settlement request
The settlement process is split-ed into 2 step:
Step | Comments |
---|---|
1. Validating the settle request XML_Message validation schema | Merchants will create the authorization XML named XML_Message request based on Plati Online version.
XML_Message contain all the necessary information to initiate an transaction settlement request in the Plati Online system; |
3. Settlement request response Settle/Error | Plati Online system will response:
|
Payment Void Request
After the authorization process you can void the transaction.
The void process is split-ed into 2 step:
Step | Comments |
---|---|
1. Validating the void request XML_Message validation schema | Merchants will create the void XML named XML_Message request based on Plati Online version.
XML_Message contain all the necessary information to initiate an transaction void request in the Plati Online system; |
3. Void request response Void/Error | Plati Online system will response:
|
Payment Refund Request
After the authorization process you have 5 days to do the Settlement request
The settlement process is split-ed into 2 step:
Step | Comments |
---|---|
1. Validating the settle request XML_Message validation schema | Merchants will create the authorization XML named XML_Message request based on Plati Online version.
XML_Message contain all the necessary information to initiate an transaction settlement request in the Plati Online system; |
3. Settlement request response Settle/Error | Plati Online system will response:
|