Tpay allows you to present and settle payments in currencies other than PLN. Currently, this is available only for card payments – other payment methods do not yet support currencies.
The solutions below apply to card payments. Additional payment methods will be added to this page as they become available.
Make sure that:
For card payments, we distinguish several currency-related solutions. They differ in who decides the currency the card is charged in, and in which currency the merchant receives the funds.
The payer can pay by card in any currency, regardless of the currency in which the payment was presented. This is a standard card payment mechanism, independent of Tpay and of the acquirer – it applies to every card and every acquirer.
The conversion is performed by the card issuer (the payer's bank), and the amount charged to the payer's card is converted into that card's currency. The merchant always receives the payment in the currency in which the transaction was created.
With this solution, the payer cannot be certain of the exact amount charged to the card – the card issuer sets the conversion rate. However, an approximate amount is easy for the payer to work out based on current exchange rates.
Example
The payment was presented in the amount of 100 PLN, and the payer pays with a card issued in EUR:
DCC is a service that converts the transaction amount "on the fly" into the payer's card currency, when the payment currency differs from the card's currency. Unlike conversion by the card issuer, the conversion happens already at the payment stage, and the payer can choose the charge currency. With this solution, the payer sees the exact payment amount in their own currency before deciding to pay.
DCC is currently available only with the Elavon acquirer. To activate this solution, or to check whether it is already enabled on your account, contact Tpay support.
Using DCC does not differ, for the integrator, from a standard card payment – you do not need to change or add anything in your integration. The only difference is visible to the payer: between filling out the card form and the start of payment processing (3DS authentication), they will be shown additional screens on which they choose the charge currency.
Example
The payment was presented in the amount of 100 PLN, and the payer pays with a card issued in EUR:
Limitations
Refunds under DCC are processed at the exchange rate in effect on the day of the refund, not the day of the sale – keep in mind that exchange rates may differ between the day of the sale and the day of the refund.
Multi-currency is the ability to present and settle a card transaction in a currency other than PLN – without the need to use conversion by the card issuer or DCC. The merchant receives the funds directly in the currency in which the transaction was created, or another currency agreed with the acquirer.
This solution is currently available only with the Worldline acquirer. Support for multi-currency with other acquirers is in preparation.
Examples
The payment was presented in the amount of 100 EUR, and the payer pays with a card issued in EUR:
The payment was presented in the amount of 100 EUR, and the payer pays with a card issued in PLN:
Refunds under multi-currency are processed at the exchange rate in effect on the day of the refund, not the day of the sale – keep in mind that exchange rates may differ between the day of the sale and the day of the refund.
To use multi-currency payments:
Currency payments can currently only be created via the API. The payment link generator in the Merchant Panel does not yet support currencies.
The following transaction currencies are available: EUR, USD, as well as ALL, AMD, AUD, AZN, BAM, BRL, CAD, CHF, CNY, CZK, DKK, GBP, GEL, HUF, INR, ISK, JPY, KZT, MDD, MKD, MXN, NOK, RON, RSD, SEK, SGD, TRY, UAH, ZAR.
If you need to accept payments in a currency that is not on the list above, report this need to your Tpay account manager – extending the list of transaction currencies is possible.
Under the agreement with Worldline, the merchant specifies the currencies in which they want to accept payments, and the currencies in which they want to receive payouts. Settlement is possible:
Available settlement currencies include: EUR, USD, GBP, CHF, DKK, HUF, NOK, SEK.
Regardless of the settlement method chosen, a payout in a given currency may still land on a bank account held in, e.g., PLN – in that case, the conversion will take place on the receiving bank's side.
Create card payments in a currency using the standard transaction creation endpoint, additionally specifying the currency field with a currency code compliant with ISO 4217, and pay.groupId: 103 (the payment group for cards).
To create a card transaction in a currency, send a POST request to the endpoint:
https://api.tpay.com/transactions
Check the details in the API Reference documentation: POST /transactions
Specify the following parameters in the request:
amount * | The transaction amount. |
currency * | Transaction currency code compliant with ISO 4217, e.g. EUR. |
description * | Description of the transaction visible to the payer. |
payer.email | Payer's email address. |
payer.name | Payer's full name. |
pay.groupId | Payment group identifier for cards: 103. |
* Fields required.
If you do not pass the currency field, the transaction will be created in the default currency, PLN.
The basic request body should look like this:
{ "amount": 100, "currency": "EUR", "description": "Test card payment in EUR", "payer": { "email": "[email protected]", "name": "John Doe" }, "pay": { "groupId": 103 } }
After sending the request, you will receive a TransactionCreated schema in the response.
The key response parameters are:
result | success - The transaction was successfully created. |
status | pending - The transaction is awaiting payment. |
currency | The transaction currency. |
transactionPaymentUrl | URL to redirect the payer to. |
Example response:
{ "result": "success", "requestId": "858fa92dc62db44e2c1f", "transactionId": "01K5BK4HEPB0WBCGT51FMTYSYJ", "title": "TR-CWM-CNYHA6X", "posId": "ps_e4dkPVDEm4Jg7267", "status": "pending", "date": { "creation": "2024-06-06 21:31:35", "realization": null }, "amount": 100, "currency": "EUR", "description": "Test card payment in EUR", "hiddenDescription": "", "payer": { "payerId": "py_a9rjlZWxRLdG1bqY", "email": "[email protected]", "name": "John Doe", "phone": "", "address": "", "city": "", "country": "PL", "postalCode": "" }, "payments": { "status": "pending", "method": "pay_by_link", "amountPaid": 0, "date": { "realization": null } }, "transactionPaymentUrl": "https://secure.tpay.com/?title=TR-CWM-CNYHA6X&uid=01HZQGHZP5P3P7YV8A4BRVDX17" }
The rest of the process – redirecting the payer, 3D Secure authentication, and handling the notification – works the same way as for a standard card transaction.
Payments in any currency can be made using: card, Apple Pay, Google Pay.
We will notify you of the transaction status via transaction posting notifications. The notification includes a currency field with the transaction currency.