📘
Credentials: Please contact your provider to obtain sandbox & production credentials

Check transfer status

Check via transfer status endpoint

You can retrieve the latest status of a transfer by calling the transfer status endpoint: GET https://api.stage.floxi.org/api/v1/payins/{id}.

Provide the payment ID (id from the response on transfer initiation), and the endpoint returns its current state along with additional details such as currency, amount, and reference. This method is useful when you need to poll for updates or verify the final result on demand.

Check via callback

You can also receive transfer status updates automatically through a callback (webhook). Specify your callbackUrl when initiating the transfer, and our system will send a notification to that URL when the payment status changes.

Webhook body example

{
                  "Id": "8f4c2f3a-9b76-4c39-9e6e-2d7c4dcb1e92",
                  "Status": "Done",
                  "OrderId": "your_order_id",
                  "Reference": "REF-20251121-1001",
                  "Currency": "EUR",
                  "Amount": 100.00,
                  "Payer": {
                    "Name": "John Doe",
                    "BankId": "BANK123456",
                    "Account": {
                      "Iban": "DE89370400440532013000"
                    }
                  },
                  "CompletedDate": "2025-11-21T12:00:00.0000000Z",
                  "EventId": "evt_20251121_0001",
                  "EventTimestamp": 1763524800000
                }

Callback signature verification

Each webhook request includes security headers for signature validation:

signature-timestamp — Unix timestamp.
signature — HMAC_SHA256(MerchantSignatureKey, signature-timestamp + "." + RequestBodyContent)

The resulting HMAC is encoded in HEX format. You must verify this signature on your end to ensure authenticity. The signature-timestamp must be unique for each callback delivery attempt

🚧
Both API key and token-based authentication methods are currently supported. Token-based authentication is strongly recommended for higher security and future compatibility, as API key-only authentication will be decommissioned by the end of March 2026.
To authenticate:

When using an API key, include it in the request as an x-api-key header.

When using a token, include it as an Authorization header in the format:

Authorization: Bearer YOUR_TOKEN