Check the Processing Status

After initiating a refund, use this endpoint to poll for its latest status. Pass the refund transaction ID (not the original PayIn transaction ID) that was returned by the Initiate Refund API. A successfully processed refund returns a SUCCESS status along with a UTR (Unique Transaction Reference) confirming the bank transfer.

Quick ReferenceMethod: POSTRequired: transaction_id (the refund transaction ID, not the original PayIn ID)Returns: status, utr, refund_amount, created_atTerminal statuses: SUCCESS, FAILED, PENDING

Endpoint Details

Field	Value
Method	`POST`
Payload	`JSON`
URL	`https://api.fastflowpe.com/merchant/payin/refund/status`

Request Headers

string

required

Your secret API key issued from the FastFlowPe merchant dashboard.

string

required

Must be application/json.

Request Body

string

required

The refund transaction ID returned by the Initiate Refund API. This is distinct from the original PayIn transaction ID.

curl --location 'https://api.fastflowpe.com/merchant/payin/refund/status' \
--header 'x-api-key: <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{"transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a"}'

import requests

url = "https://api.fastflowpe.com/merchant/payin/refund/status"
headers = {"x-api-key": "<your-api-key>", "Content-Type": "application/json"}
payload = {"transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a"}

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

const response = await fetch("https://api.fastflowpe.com/merchant/payin/refund/status", {
  method: "POST",
  headers: {
    "x-api-key": "<your-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ transaction_id: "636724e7-80d1-4cfd-8db3-ace0bec0616a" }),
});
console.log(await response.json());

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

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.fastflowpe.com/merchant/payin/refund/status"))
    .header("x-api-key", "<your-api-key>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"transaction_id\": \"636724e7-80d1-4cfd-8db3-ace0bec0616a\"}"))
    .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(`{"transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a"}`)
    req, _ := http.NewRequest("POST", "https://api.fastflowpe.com/merchant/payin/refund/status", bytes.NewBuffer(payload))
    req.Header.Set("x-api-key", "<your-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
$ch = curl_init("https://api.fastflowpe.com/merchant/payin/refund/status");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["transaction_id" => "636724e7-80d1-4cfd-8db3-ace0bec0616a"]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: <your-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/payin/refund/status')
request = Net::HTTP::Post.new(uri)
request['x-api-key'] = '<your-api-key>'
request['Content-Type'] = 'application/json'
request.body = { transaction_id: '636724e7-80d1-4cfd-8db3-ace0bec0616a' }.to_json

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

Response

Both a successful refund and a failed refund return an HTTP 200 with "status": "success" — the outcome of the refund itself is reflected in data.status. A 4xx response with "status": "error" is returned when the request itself is invalid (e.g. an unrecognised transaction ID).

{
  "status": "success",
  "status_code": 200,
  "message": "Refund status retrieved successfully",
  "data": {
    "transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a",
    "original_transaction_id": "a6aac4a4-9516-4076-9b01-e28c3c57aa80",
    "status": "SUCCESS",
    "amount": "150.00",
    "utr": "619704648408"
  }
}

{
  "status": "success",
  "status_code": 200,
  "message": "Refund status retrieved successfully",
  "data": {
    "transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a",
    "original_transaction_id": "a6aac4a4-9516-4076-9b01-e28c3c57aa80",
    "status": "FAILED",
    "amount": "150.00",
    "utr": null
  }
}

{
  "status": "error",
  "status_code": "4xx",
  "message": "<reason for failure>",
  "data": null
}

Response Fields

string

The refund transaction UUID you queried.

string

The UUID of the original PayIn transaction that this refund was raised against.

string

The outcome of the refund. Possible values are SUCCESS, FAILED, or INITIATED (still processing).

string

The refund amount that was requested.

string

The Unique Transaction Reference issued by the bank confirming the refund transfer. This is null when the refund has not yet succeeded.

Refund Webhook Payloads

FastFlowPe also pushes a callback to your configured webhook URL when a refund’s status changes, so you don’t need to poll continuously.

{
  "transaction": {
    "id": "<Transaction UUID>",
    "amount": "<Transaction amount>",
    "payment_type": "<Payment mode>",
    "utr": "<Unique Transaction Reference>",
    "status": "SUCCESS",
    "transaction_details": "<Customer info object>"
  }
}

{
  "transaction": {
    "id": "<Transaction UUID>",
    "amount": "<Transaction amount>",
    "payment_type": "<Payment mode>",
    "utr": null,
    "status": "FAILED",
    "transaction_details": "<Customer info object>"
  }
}

Configure your webhook URL in the dashboard under Settings → Webhooks to receive real-time refund status updates. See the Callback Configuration guide for setup instructions.

⌘I

curl --location 'https://api.fastflowpe.com/merchant/payin/refund/status' \
--header 'x-api-key: <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{"transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a"}'

import requests

url = "https://api.fastflowpe.com/merchant/payin/refund/status"
headers = {"x-api-key": "<your-api-key>", "Content-Type": "application/json"}
payload = {"transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a"}

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

const response = await fetch("https://api.fastflowpe.com/merchant/payin/refund/status", {
  method: "POST",
  headers: {
    "x-api-key": "<your-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ transaction_id: "636724e7-80d1-4cfd-8db3-ace0bec0616a" }),
});
console.log(await response.json());

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

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.fastflowpe.com/merchant/payin/refund/status"))
    .header("x-api-key", "<your-api-key>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"transaction_id\": \"636724e7-80d1-4cfd-8db3-ace0bec0616a\"}"))
    .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(`{"transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a"}`)
    req, _ := http.NewRequest("POST", "https://api.fastflowpe.com/merchant/payin/refund/status", bytes.NewBuffer(payload))
    req.Header.Set("x-api-key", "<your-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
$ch = curl_init("https://api.fastflowpe.com/merchant/payin/refund/status");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["transaction_id" => "636724e7-80d1-4cfd-8db3-ace0bec0616a"]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: <your-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/payin/refund/status')
request = Net::HTTP::Post.new(uri)
request['x-api-key'] = '<your-api-key>'
request['Content-Type'] = 'application/json'
request.body = { transaction_id: '636724e7-80d1-4cfd-8db3-ace0bec0616a' }.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": "Refund status retrieved successfully",
  "data": {
    "transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a",
    "original_transaction_id": "a6aac4a4-9516-4076-9b01-e28c3c57aa80",
    "status": "SUCCESS",
    "amount": "150.00",
    "utr": "619704648408"
  }
}

{
  "status": "success",
  "status_code": 200,
  "message": "Refund status retrieved successfully",
  "data": {
    "transaction_id": "636724e7-80d1-4cfd-8db3-ace0bec0616a",
    "original_transaction_id": "a6aac4a4-9516-4076-9b01-e28c3c57aa80",
    "status": "FAILED",
    "amount": "150.00",
    "utr": null
  }
}

{
  "status": "error",
  "status_code": "4xx",
  "message": "<reason for failure>",
  "data": null
}

Get Started

Collections

Payment Links

Fund Transfer

Refunds

Callbacks

Check the Processing Status

Endpoint Details

Request Headers

Request Body

Response

Response Fields

Refund Webhook Payloads

​Endpoint Details

​Request Headers

​Request Body

​Response

​Response Fields

​Refund Webhook Payloads

Endpoint Details

Request Headers

Request Body

Response

Response Fields

Refund Webhook Payloads