Idempotent by design
The same key with the same body returns the same link: a repeated call never creates a second payment.
Developers
FastTrackPay is an endpoint of the Wealthreader payments API: HTTPS and JSON. Send the payment, redirect your customer and receive the notification with your reference.
To get started, we enable payments and your payment profile on your Wealthreader API key. If you already use the API, it is the same key.
A POST with your API key, an idempotency key that is also your reference, and the payment body: amount, currency, beneficiary, payment reference, priority and notification URL.
# Create the payment
curl 'https://api.wealthreader.com/payments/?action=fast-track' \
-H "X-API-Key: $API_KEY" \
-H "Idempotency-Key: invoice-F-2026-104" \
-H "Content-Type: application/json" \
-d '{
"amount": "2450.00",
"currency": "EUR",
"beneficiary": {
"name": "Example Company Ltd",
"iban": "ES9121000418450200051332"
},
"reference": "Invoice F-2026-104",
"priority": "instant",
"notification_url": "https://example.com/payments/notice"
}'
The response contains the payment URL and its identifier. Redirect your customer to the URL: it expires within a few minutes (15 by default), so create it when they are about to pay.
{
"url": "https://widget.wealthreader.com/payments/pay/#payment_intent_id=…&widget_token=…",
"payment_intent_id": "22222222-2222-4222-8222-222222222222"
}
When the payment reaches a final status, we send a POST to your notification_url with outcome ok or ko and your reference in customer_reference. Respond with a 2xx code.
The notification may arrive more than once and is not signed: before handing over anything valuable, confirm the status with POST /payments/?action=status.
{
"outcome": "ok",
"payment_status": "settled",
"customer_reference": "invoice-F-2026-104",
"payment_intent_id": "22222222-2222-4222-8222-222222222222"
}
Headers, fields, statuses and errors for POST /payments/?action=fast-track. The full detail is in the guide.
| Header | Validation |
|---|---|
X-API-Key | Your Wealthreader API key, with payments enabled. |
Idempotency-Key | 16 to 128 characters: letters, numbers and . _ : -. It is your reference for the payment and comes back in the notification as customer_reference. |
| Field | Validation | Required |
|---|---|---|
amount | Amount in euros as a string, with up to two decimals: "2450.00". Minimum 0.01. | Yes |
currency | EUR. | Yes |
beneficiary.name | Beneficiary name, 1 to 140 characters. | Yes |
beneficiary.iban | Beneficiary IBAN, without spaces and with valid check digits. It does not need to be registered beforehand. | Yes |
reference | Payment reference your customer sees and that appears on the bank statement, up to 140 characters. | Yes |
priority | instant for an instant transfer or normal for a standard transfer. | Yes |
notification_url | Public https URL to which we send the ok or ko notification. | Yes |
logo | Public https URL of your company logo in SVG, which the payment page shows next to the beneficiary. | No |
payment_status | Meaning | outcome |
|---|---|---|
settled |
The bank has settled the payment. | ok |
rejected |
The bank has rejected the payment, including because of the amount or because it does not support instant transfers. | ko |
cancelled |
It was cancelled before completion. | ko |
expired |
The payment session expired before completion. | ko |
failed |
The payment could not be completed. | ko |
pending |
In progress: not yet a final status. | No notification yet |
| HTTP | Code | Meaning |
|---|---|---|
400 |
idempotency_key_required |
The Idempotency-Key header is missing or its length is invalid. |
401 |
invalid_api_key |
Invalid API key. |
403 |
payments_not_allowed, payment_profile_required |
Your key does not have payments enabled or lacks a payment profile. |
409 |
idempotency_conflict |
You reused an Idempotency-Key with different data. |
422 |
invalid_request, invalid_amount, invalid_beneficiary, invalid_notification_url |
Invalid body: an extra or missing field, or an incorrect amount, beneficiary or notification URL. |
429 |
api_limit_reached |
You have reached the call limit. |
503 |
payments_disabled |
Payments are not available at the moment. |
Errors return JSON with success set to false and the code from the table in error.code.
The same key with the same body returns the same link: a repeated call never creates a second payment.
Choose an instant or a standard transfer for each payment. If the bank does not accept instant transfers, the notification arrives as ko.
Send the URL of your SVG logo and the payment page shows it next to the beneficiary’s name.
Your customer reviews the amount, beneficiary and payment reference, picks their bank and authorises. For now, the page is shown in Spanish.
Open the Fast Track payments guide (opens in a new tab) Open the API reference (opens in a new tab) Request access
We will show you FastTrackPay with the payments your business collects.