Skip to content

Bank Transfer

MF Integration option

Payment

Info

This integration option supports only EUR and GBP currencies.

Payment flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends the payment request to Freepayment.
  3. Freepayment sends a response containing the URL for completing the payment.
  4. The merchant redirects the customer to the provided URL.
  5. The customer completes the payment.
  6. Freepayment sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from Freepayment using the status query.
Request

Send a payment request with the following additional parameters:

object
return_url
required
string
A URL to which the customer is redirected after the transaction is completed.
ip
string
The customer's IP address.
object
A section of the payment method information.
type
required

string
bank_transfer
account_number
string
IBAN of the customer's account.
object
A section of information about the customer.
first_name
required
string
The customer's first name.
last_name
required
string
The customer's last name.
email
required
string
The customer's email address.
country
required
string (2)
The customer's country in the ISO 3166-1 Alpha-2 format.
external_id
string
The customer's identifier in the merchant's system.
birth_date
string
The customer's date of birth in the ISO 8601 format (YYYY-MM-DD).
phone
string
The customer's phone number without the special characters.
address
string (510)
The customer's address.
city
string (50)
The customer's city.
zip
string (12)
The postal code of the customer's address.
state
string (40)
The customer's state/region.
Request example
{
    "request": {
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://return-url/",
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "example@example.com",
            "country": "BE"
        },
        "method": {
            "type": "bank_transfer",
            "account_number": "BE12345678901234"
        }
    }
}
Response

Redirect the customer to the URL received as the value of the form.action parameter.

Response example
{
    "transaction": {
        "uid": "2b9073db-8548-4b1b-8d5a-bc60683f1cf3",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2026-06-09T15:31:57Z",
        "updated_at": "2026-06-09T15:32:03Z",
        "method_type": "bank_transfer",
        "receipt_url": "https://backoffice.stelixor.io/customer/transactions/2b9073db-8548-4b1b-8d5a-bc60683f1cf3/7aa7981fe4c827222def087e56d0dc9b32272a38ad74a5bc5175812fe386fa61",
        "payment": {
            "status": "pending",
            "gateway_id": 6749,
            "ref_id": "880cb9ffb30446379b17ff0f2423a8ae",
            "message": "Transaction was initialized."
        },
        "bank_transfer": {
            "type": "bank_transfer",
            "account_number": "BE12345678901234"
        },
        "customer": {
            "email": "example@example.com",
            "country": "BE",
            "last_name": "Doe",
            "first_name": "John",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": true,
        "billing_address": {
            "email": "example@example.com",
            "country": "BE",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}