Skip to content
HesabPay HesabPay Docs
Dashboard
Sandbox Production

Multi-Vendor Transfer

Multi-vendor transfer is used when a marketplace needs to distribute funds to multiple vendor accounts.

POST /api/v1/payment/send-money-MultiVendor

Distributes funds to multiple vendor accounts after a payment flow. Use it only when marketplace settlement is enabled for the merchant.

Body Params

pin string required

Encrypted merchant account PIN. The raw PIN must never be sent directly.

vendors array<object> required

Vendor settlement entries. Each vendor account should appear only once in a request.

account_number string required

HesabPay account number for the vendor receiving the settlement amount.

amount number required

Amount to transfer to the vendor account. The total must be valid for the transaction and merchant balance.

Responses

200 Transfer accepted

The vendor transfer request was accepted and processed successfully.

{
  "success": true,
  "status_code": 10,
  "message": "Operation successful",
  "transaction_detail": [
    {
      "transaction_id": "0843947001779017897",
      "amount": "25.00"
    },
    {
      "transaction_id": "0858298001779017897",
      "amount": "30.00"
    }
  ],
  "transaction_date": "2026-05-17 16:08:17",
  "amount": 55
}
400 Bad Request

The vendor payload is invalid, duplicated, incomplete, or fails settlement rules.

{
  "success": false,
  "message": "Invalid vendor payload"
}
401 Not authenticated

The API key is missing, malformed, inactive, or invalid.

{
  "detail": "Invalid or missing Authorization header."
}

Constraints

Section titled “Constraints”
  • PIN must be encrypted before sending.
  • Do not duplicate vendor account numbers in one request.
  • Total vendor amount must be valid for the transaction and account balance.
  • Use webhooks and reconciliation records to avoid duplicate settlements.