Developers

One call. One payment link.

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.

  1. Create the payment

    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"
      }'
  2. Send your customer to the link

    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"
    }
  3. Receive the notification

    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"
    }

Quick reference

Headers, fields, statuses and errors for POST /payments/?action=fast-track. The full detail is in the guide.

Request headers
HeaderValidation
X-API-KeyYour Wealthreader API key, with payments enabled.
Idempotency-Key16 to 128 characters: letters, numbers and . _ : -. It is your reference for the payment and comes back in the notification as customer_reference.
Body fields
FieldValidationRequired
amountAmount in euros as a string, with up to two decimals: "2450.00". Minimum 0.01.Yes
currencyEUR.Yes
beneficiary.nameBeneficiary name, 1 to 140 characters.Yes
beneficiary.ibanBeneficiary IBAN, without spaces and with valid check digits. It does not need to be registered beforehand.Yes
referencePayment reference your customer sees and that appears on the bank statement, up to 140 characters.Yes
priorityinstant for an instant transfer or normal for a standard transfer.Yes
notification_urlPublic https URL to which we send the ok or ko notification.Yes
logoPublic https URL of your company logo in SVG, which the payment page shows next to the beneficiary.No
Payment statuses and notification
payment_statusMeaningoutcome
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
Error codes
HTTPCodeMeaning
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.

Integration details

Idempotent by design

The same key with the same body returns the same link: a repeated call never creates a second payment.

Instant or standard

Choose an instant or a standard transfer for each payment. If the bank does not accept instant transfers, the notification arrives as ko.

Your brand on the payment

Send the URL of your SVG logo and the payment page shows it next to the beneficiary’s name.

The payment page

Your customer reviews the amount, beneficiary and payment reference, picks their bank and authorises. For now, the page is shown in Spanish.

Don’t ask your customer for a transfer: send them a prepared payment

We will show you FastTrackPay with the payments your business collects.

Request a demo