Initiate a Payout

Once you have a registered beneficiary and their contact_id, you’re ready to move money. This endpoint debits your merchant virtual account and pushes funds to the beneficiary’s bank account using the payment mode you specify. You can choose IMPS for instant transfers, NEFT for batch processing, or RTGS for high-value real-time settlements.

Quick ReferenceRequired: contact_id, amount, mode, reference_idModes: IMPS, NEFT, RTGSReturns: transaction_id, status

Endpoint

POST https://api.fastflowpe.com/merchant/api/v2/payout/initialize

Request Headers

Header	Value
`x-api-key`	Your API key
`Content-Type`	`application/json`

Request Body Parameters

string

required

The bank transfer mode to use. Accepted values:

IMPS — Immediate, 24×7 real-time transfer
NEFT — Batch transfer, processed in hourly cycles
RTGS — Real-time, suited for high-value transfers

float

required

The amount to transfer, in INR (e.g., 1000 for ₹1,000). Must be a positive value within your account balance.

string

required

Your Virtual Account ID. This is provisioned by the FastFlowPe team and is also available on your merchant dashboard. Every payout is debited from the balance associated with this va_id.

string

The contact_id returned when you created the beneficiary. Identifies which registered bank account to credit.

string

Your own reference ID for this transaction — for example, an internal order ID or disbursement batch number. Pass this value to correlate payout records in your system with FastFlowPe transactions, and use it later to look up status if you don’t have the transaction_id.

curl --location 'https://api.fastflowpe.com/merchant/api/v2/payout/initialize' \
--header 'x-api-key: <your-x-api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "payment_type": "IMPS",
    "amount": 1000,
    "contact_id": "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
    "merchant_ref_id": "TXN_REF_001",
    "va_id": "SVA-123456"
}'

import requests

url = "https://api.fastflowpe.com/merchant/api/v2/payout/initialize"
headers = {"x-api-key": "<your-x-api-key>", "Content-Type": "application/json"}
payload = {
    "payment_type": "IMPS",
    "amount": 1000,
    "contact_id": "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
    "merchant_ref_id": "TXN_REF_001",
    "va_id": "SVA-123456",
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://api.fastflowpe.com/merchant/api/v2/payout/initialize", {
  method: "POST",
  headers: {
    "x-api-key": "<your-x-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    payment_type: "IMPS",
    amount: 1000,
    contact_id: "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
    merchant_ref_id: "TXN_REF_001",
    va_id: "SVA-123456",
  }),
});
console.log(await response.json());

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String body = """
{
  "payment_type": "IMPS",
  "amount": 1000,
  "contact_id": "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
  "merchant_ref_id": "TXN_REF_001",
  "va_id": "SVA-123456"
}
""";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.fastflowpe.com/merchant/api/v2/payout/initialize"))
    .header("x-api-key", "<your-x-api-key>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := []byte(`{
        "payment_type": "IMPS",
        "amount": 1000,
        "contact_id": "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
        "merchant_ref_id": "TXN_REF_001",
        "va_id": "SVA-123456"
    }`)

    req, _ := http.NewRequest("POST", "https://api.fastflowpe.com/merchant/api/v2/payout/initialize", bytes.NewBuffer(payload))
    req.Header.Set("x-api-key", "<your-x-api-key>")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

<?php
$payload = json_encode([
    "payment_type" => "IMPS",
    "amount" => 1000,
    "contact_id" => "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
    "merchant_ref_id" => "TXN_REF_001",
    "va_id" => "SVA-123456",
]);

$ch = curl_init("https://api.fastflowpe.com/merchant/api/v2/payout/initialize");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: <your-x-api-key>",
    "Content-Type: application/json",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.fastflowpe.com/merchant/api/v2/payout/initialize')
request = Net::HTTP::Post.new(uri)
request['x-api-key'] = '<your-x-api-key>'
request['Content-Type'] = 'application/json'
request.body = {
  payment_type: 'IMPS',
  amount: 1000,
  contact_id: '0d39ff01-eebe-4d7c-9e89-f4ae657605f4',
  merchant_ref_id: 'TXN_REF_001',
  va_id: 'SVA-123456',
}.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body

{
    "status": "success",
    "status_code": 200,
    "message": "Payout Initiation Success",
    "data": {
        "message": "Payout Initiation Success",
        "transaction_id": "your-transaction-id-here",
        "reason": "Message String Here"
    }
}

Response

string

Top-level result of the API call — success or error.

integer

HTTP status code for the operation (e.g., 200).

string

Human-readable summary of the result.

object

Details of the initiated payout.

Show data fields

string

FastFlowPe’s unique identifier for this payout transaction. Store this value — you’ll use it to check the payout status using the Check Status API.

string

Confirmation message for the payout initiation.

string

Additional context or reason string from the payment network, if available.

A successful response ("status": "success") means FastFlowPe has accepted and queued your payout request — it does not mean the funds have already reached the beneficiary. Use the Check Status API with the returned transaction_id to confirm final settlement.

Always populate merchant_ref_id with a unique identifier from your own system (such as an order ID or batch reference). This gives you a second lookup key if you ever need to query status without the transaction_id, and it makes reconciliation significantly easier.

⌘I

curl --location 'https://api.fastflowpe.com/merchant/api/v2/payout/initialize' \
--header 'x-api-key: <your-x-api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "payment_type": "IMPS",
    "amount": 1000,
    "contact_id": "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
    "merchant_ref_id": "TXN_REF_001",
    "va_id": "SVA-123456"
}'

import requests

url = "https://api.fastflowpe.com/merchant/api/v2/payout/initialize"
headers = {"x-api-key": "<your-x-api-key>", "Content-Type": "application/json"}
payload = {
    "payment_type": "IMPS",
    "amount": 1000,
    "contact_id": "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
    "merchant_ref_id": "TXN_REF_001",
    "va_id": "SVA-123456",
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://api.fastflowpe.com/merchant/api/v2/payout/initialize", {
  method: "POST",
  headers: {
    "x-api-key": "<your-x-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    payment_type: "IMPS",
    amount: 1000,
    contact_id: "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
    merchant_ref_id: "TXN_REF_001",
    va_id: "SVA-123456",
  }),
});
console.log(await response.json());

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String body = """
{
  "payment_type": "IMPS",
  "amount": 1000,
  "contact_id": "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
  "merchant_ref_id": "TXN_REF_001",
  "va_id": "SVA-123456"
}
""";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.fastflowpe.com/merchant/api/v2/payout/initialize"))
    .header("x-api-key", "<your-x-api-key>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := []byte(`{
        "payment_type": "IMPS",
        "amount": 1000,
        "contact_id": "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
        "merchant_ref_id": "TXN_REF_001",
        "va_id": "SVA-123456"
    }`)

    req, _ := http.NewRequest("POST", "https://api.fastflowpe.com/merchant/api/v2/payout/initialize", bytes.NewBuffer(payload))
    req.Header.Set("x-api-key", "<your-x-api-key>")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

<?php
$payload = json_encode([
    "payment_type" => "IMPS",
    "amount" => 1000,
    "contact_id" => "0d39ff01-eebe-4d7c-9e89-f4ae657605f4",
    "merchant_ref_id" => "TXN_REF_001",
    "va_id" => "SVA-123456",
]);

$ch = curl_init("https://api.fastflowpe.com/merchant/api/v2/payout/initialize");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: <your-x-api-key>",
    "Content-Type: application/json",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.fastflowpe.com/merchant/api/v2/payout/initialize')
request = Net::HTTP::Post.new(uri)
request['x-api-key'] = '<your-x-api-key>'
request['Content-Type'] = 'application/json'
request.body = {
  payment_type: 'IMPS',
  amount: 1000,
  contact_id: '0d39ff01-eebe-4d7c-9e89-f4ae657605f4',
  merchant_ref_id: 'TXN_REF_001',
  va_id: 'SVA-123456',
}.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body

{
    "status": "success",
    "status_code": 200,
    "message": "Payout Initiation Success",
    "data": {
        "message": "Payout Initiation Success",
        "transaction_id": "your-transaction-id-here",
        "reason": "Message String Here"
    }
}

Get Started

Collections

Payment Links

Fund Transfer

Refunds

Callbacks

Endpoint

Request Headers

Request Body Parameters

Response

​Endpoint

​Request Headers

​Request Body Parameters

​Response

Endpoint

Request Headers

Request Body Parameters

Response