post https://api.sandbox.uqpay.tech/api/v1/payouts
Creates a new payout to a beneficiary. With development and support from SWIFT and local payment rails, you can make faster and more cost-effective international payments to your overseas corporate accounts, suppliers, and employees.
This API supports multiple payment modes, including standard payouts and Payment-On-Behalf-Of (POBO), enabling flexible and efficient fund management. Additionally, you can select the fee payment method to control how transaction fees are handled.
Usage Guidelines
- Supports payouts to over 180 countries in 30+ currencies, including CNY payouts in Mainland China.
- Sub-accounts for POBO transactions must be created in advance, and the account status must be active.
- To enable POBO mode, include the
x-on-behalf-of
parameter in the request header and specify the sub-account ID used for the payout. The beneficiary will see the customized payer name instead of the actual paying entity. - Users can select the fee charge type by
fee_paid_by
parameter to determine who covers transaction costs:SHARED
– Transaction fees are split between payer and recipient; payer pays sending bank fees while recipient pays receiving bank fees.OURS
– All transaction fees, including intermediary bank charges, are paid by the payer.
- There are two ways to specify the beneficiary:
- Using
beneficiary_id
– If the beneficiary has already been created, provide thebeneficiary_id
to reference an existing beneficiary. - Providing full beneficiary details – If the beneficiary has not been created before, include the full beneficiary information in the request. In this case, do not pass
beneficiary_id
.
- Using