Merchant Payouts (Transfers)

The Payout endpoint allows merchants to transfer funds from their FinovoPay wallet balance directly to any commercial bank account in Nigeria. This uses the NIP (Nigeria Inter-bank Settlement System) for instant settlement.

Endpoint Details

Base URL https://merchant.finovopay.com/v1/index.php

Method POST

Request Parameters

Field	Required	Description
action	Yes	Must be set to `withdraw`
amount	Yes	The amount to be transferred (e.g., 5000.00).
bank_code	Yes	Standard 3-digit NIP bank code.
account_number	Yes	The 10-digit NUBAN account number.

Implementation Example

Sample Request Payload

{
  "action": "withdraw",
  "amount": 2500,
  "bank_code": "044",
  "account_number": "0123456789",
  "account_name": "REIGNHOST TECHNOLOGIES"
}

Success Response

{
  "success": true,
  "message": "Transfer initiated successfully.",
  "data": {
      "transaction_ref": "FP_TR_8A1B2C3D4E",
      "status": "pending"
  }
}

Operational Safety

Atomic Transactions

Our gateway uses atomic operations. If the inter-bank transfer fails, your wallet balance will not be deducted.

Latency Management

Payouts can take up to 60 seconds. Do not retry requests until you receive a final response.