Request Payment Transfer

post

https://sandbox.tillo.dev/api/v2/float/request-payment-transfer

Request a payment transfer to one of your floats. This creates a pending payment that will be processed by the finance team.

Float & Currency

Use the /check-floats endpoint to find your available floats. The float and currency must match an existing combination (e.g. universal-float + GBP, amazon + USD).

Payment Reference

Optional. If not provided, one will be generated automatically. We recommend using unique references for tracking.

Finance Email

Optional email override for the invoice recipient. Required if your account has no default finance email configured.

Proforma Invoice

Optional company details override (requires Proforma Invoicing feature). If provided, company_name is required.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

float

string

required

length between 1 and 255

Float identifier from the check-floats endpoint (e.g. universal-float, brand-specific float name)

payment_reference

string

length between 1 and 18

Optional payment reference. If not provided, Tillo will generate one automatically. Uniqueness is not enforced, but unique references are recommended.

finance_email

string

length ≤ 255

Optional finance email address to override the default recipient. Required if partner has no default finance email configured.

proforma_invoice

object

Optional proforma invoice company details override. Only available if partner has proforma invoicing feature enabled. If provided, company_name is required.

currency

string

enum

length between 3 and 3

^[A-Z]{3}$

amount

^\d+(\.\d{1,2})?$

Amount to transfer. Accepts either a string or number. String amounts can have any number of decimal places (e.g., "300.1000000000001") and will be normalized to 2 decimal places in the response. Minimum value is 0.01, maximum is 99,999,999.99.

Responses

200Payment transfer request successfully registered

400Bad request. Invalid or missing required parameters.

401Unauthorized - partner account is disabled or invalid credentials

422Validation error - invalid request parameters