Basic Information
This document has been prepared to help you manage all your payment processes end to end by integrating the Finrota Payment Web Service (PWS) REST API services into your system.
Purpose; to securely manage payment sets, POS rates, payment initiation–completion steps, and cancellation/refund operations through a single, holistic API structure.
What Is It For?
The Finrota payment infrastructure is designed to enable member merchants or dealers to manage their payment transactions.
It supports the following main functionalities
- Listing defined payment sets, POS terminals, and rates
- Initiating and completing a new payment request
- Viewing details of completed transactions
- Returning detailed responses compatible with the GetPayment logic integrated with ERP systems
- Performing cancellation (cancel) and refund (refund) operations via reference or merchant reference
How Does It Connect?
- All services operate over the HTTPS/REST protocol.
- Data exchange is performed in JSON format with the UTF-8 character set.
- All calls must be encrypted with TLS 1.2+.
Security
- Bearer Token–based authorization (AccessToken) is mandatory.
- For obtaining and renewing tokens, see: 2. Authentication – Obtaining an AccessToken.
- Each request must include a valid AccessToken; expired tokens return a 401 error.
Environments
| Environment | URL | Description |
|---|---|---|
| Demo Environment (Sandbox) | https://pgw.netahsilatdemo.com | Test and development environment; no real financial transactions are performed. |
| Live Environment (Production) | https://api.finrota.com | Environment where real payment transactions are processed. |