Payout APIs
Simple guide for initiating payouts using HitPay API
Overview
This guide shows how to initiate payouts using HitPay’s transfer API. It’s an essential tool for platforms and businesses that need to pay suppliers or other entities.
Example Use Cases
These APIs are designed for a variety of payment scenarios, including:
- Paying suppliers
- Employee payroll
- Automating commission payouts to partners
Flow of Funds
When you initiate a transfer, funds are deducted from your HitPay wallet balance. Your wallet can hold balances in multiple currencies such as SGD, USD, etc. The API uses the source_currency
field to deduct from the corresponding wallet.
Funds can be added to your wallet through:
- Accepting payments using HitPay (e.g., through your checkout or POS)
- Manual top-ups via the HitPay Dashboard
Example: PayNow Transfer from SGD Wallet
The diagram below illustrates how funds are deducted during a PayNow transfer:
- Total wallet balance: SGD 1,000
- PayNow transfer: SGD 250
- Transfer fee: SGD 0.50
- Remaining balance: SGD 749.50
You can also initiate transfers from other balances like USD if supported for the payout method.
Endpoint
Required Fields
Field | Description |
---|---|
beneficiary | Inline object or beneficiary_id |
source_currency | Currency to deduct from (e.g., sgd ) |
payment_amount | Amount to transfer |
Below is a sample request body to initiate a transfer using different payout methods.
Transfer API Response
Upon successfully initiating a transfer, the API returns a JSON object containing the details of the transfer. Below is a sample response:
Other APIs
While using the POST /v1/transfers
endpoint is the simplest way to get started with payouts, your integration may require more flexibility. HitPay provides additional APIs to support advanced use cases:
-
Create Beneficiary
If you intend to save a beneficiary and reuse them for multiple payouts, this API allows you to create and manage stored beneficiaries. -
Webhook Events
Some transfer types may not be completed instantly. Use webhook notifications to track changes in transfer status and trigger downstream actions when a transfer is successful or fails. -
Estimate Fees
Before initiating a transfer, you can use this API to estimate the transfer fee. This is particularly helpful when the transfer involves currency conversion or if you’d like to display fee information to the user in advance.
Was this page helpful?