Sending funds

Overview

Reservepay allows you to send payouts from your merchant balance to your own bank account or directly to your contacts. This guide covers how to manage your balance, set up payout destinations, and initiate transfers.

Managing your balance

Before you can send funds, you need to have an available balance in your merchant account. You can check your current balance using the get-balance endpoint.

Payout methods

You can send funds in two main ways:

1. To your primary bank account: Typically used for settling your own merchant funds.
2. To a contact: Send funds directly to a customer or partner via bank account, mobile number (PromptPay), or National ID (PromptPay).

Sending payouts to your primary bank account

To receive funds into your own bank account, you must have configured a primary bank account during the merchabt onboarding.

Initiate a payout

Once your primary bank account is set, you can send funds using send-payout.

curl -X POST https://api.reservepay.com/merchants/send-payout \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "amount": "10000",
    "external_id": "payout_001"
  }'

Sending payouts to contacts

You can send funds directly to your contacts using the send-payout-to-contact endpoint.

Payout destinations for contacts

When sending to a contact, you can specify the destination in several ways:

• Bank account: Use the contact's primary bank account by providing only the recipient_id.
• Specific bank account: Provide both recipient_id and bank_account_id.
• New bank account: Provide bank details (bank_account_number, bank_account_name, bank_code, country_code) to create and use a new account for the contact.
• Mobile number (PromptPay): Set payout_method to mobile_number and provide the mobile_number.
• National ID (PromptPay): Set payout_method to national_id and provide the national_id (13 digits).

Example: Sending to a contact's mobile number

curl -X POST https://api.reservepay.com/merchants/send-payout-to-contact \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "recipient_id": "ctc_12345",
    "payout_method": "mobile_number",
    "mobile_number": "0812223333",
    "amount": "50000"
  }'

Error handling

When sending funds, you should be prepared to handle common errors:

• INSUFFICIENT_BALANCE: Your merchant account doesn't have enough funds for the requested payout.
• INVALID_MOBILE_NUMBER / INVALID_NATIONAL_ID: The PromptPay details provided are incorrect.
• NOT_FOUND: The specified contact or bank account could not be found.