Skip to main content
A sub-client can pay a beneficiary on behalf of one of its own customers. The payout leaves from the sub-client’s account, and it names the business it is paid for: the ultimate payor. Kira screens that business before any money moves for it.

​
What it takes

Three things have to be true before a payout on behalf of someone else goes out:
  1. The sub-client holds the pobo capability.
  2. The business it pays for is registered as an ultimate payor and has cleared screening.
  3. The payout is paid from the virtual account’s USD balance or funded with crypto, pays a SWIFT recipient, is priced with a quotation made for it, and names that payor.
Each one has its own step below. None of them is reported by a webhook, so read the status the step points to.
1

Request the capability

Request a capability with capability: "pobo" for a verified business sub-client. The answer carries a verification_link.Send the sub-client to that link. It answers questions about who it pays for and how it screens them, and attaches its policy documents. Compliance then reviews the answers.How a request is decided covers every outcome. Move on once status is approved.
2

Register the ultimate payor

Create an ultimate payor with the business’s legal name, city and country, and the sub-client’s user_id as sub_client_id. Register each business the sub-client pays for once.Kira screens the payor after the call returns. How a payor clears says how to follow it. Move on once status is verified.
3

Add the beneficiary

Create a recipient for the sub-client with account.account_type: "SWIFT". A payout on behalf of others pays only a SWIFT recipient.
4

Price the payout

Create a quotation for the sub-client’s virtual account at version 2026-06-01, and keep its quote_id. If your account is pinned to an earlier version, send X-Api-Version: 2026-06-01 on this call.Send it with:
  • pobo: true,
  • rail: "WIRE_SWIFT",
  • target.currency: "USD",
  • how the payout is funded: from_held_balance: true to pay from the USD balance the virtual account holds, or payment_instructions, the token and chain you will deposit.
The quote costs more than a plain payout’s. It adds a pobo line, a percentage of the amount, and its rail fee is wire_international_swift_pobo_outbound in place of the SWIFT fee.
5

Send the payout

Execute a payout from the sub-client’s virtual account, funded the way the quotation was: from its USD balance, or with crypto. Send it with:
  • pobo: true,
  • ultimate_payor_id, the payor’s id,
  • quote_id, from the quotation,
  • recipient_id, the SWIFT recipient.
The payout comes back with pobo: true, and so does every later read of it. A payout from the USD balance needs the balance to cover the amount and its fees, as any payout from the balance does.

​
What Kira sets up

A payout on behalf of others also needs two things only Kira can set up for the account: a sender account for the sub-client, and the route these payments travel on. It reaches only the recipients that route can pay. Ask your Kira contact to set both up, and which recipients can be paid this way, before you send the first one.

​
What goes wrong

The payout is refused before any money moves. Read code on the error. Execute a payout lists every error.