Payment methods
Trustly
Bank transfers from European banks via Trustly
Before you start
Authorization
How to sign your requests with the API token.
Create payment
The base order request that this page extends.
This payment method is not enabled for all merchants. Check availability with your manager.
Overview
Trustly is a regular order with two extra fields:
| Field | Type | Description |
|---|---|---|
extraParams | string | Always trustly |
customer | object | Payer details, see below |
The payer is redirected to paymentLink, selects their bank and confirms the transfer in online banking. Trustly supports banks across Europe.
Customer fields
| Field | Type | Required | Description |
|---|---|---|---|
firstName | string | ✅ Yes | First name |
lastName | string | ✅ Yes | Last name |
email | string | ✅ Yes | Payer email |
The set of required fields may vary depending on your merchant settings. Confirm the exact requirements with your manager.
Request example
curl -X POST "https://api.riopay.online/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": "1500.00",
"externalId": "order_12345",
"purpose": "Payment for order #12345",
"extraParams": "trustly",
"customer": {
"firstName": "John",
"lastName": "Doe",
"email": "customer@example.com"
}
}'Response
The response is a standard order object. The order is created with the CREATED status; redirect the payer to paymentLink to complete the payment.