Check PayIn Transaction Status

After initiating a PayIn transaction, use this endpoint to retrieve its current status. Pass the transaction_id you received from the Initiate PayIn response, and FastFlowPe returns the payment outcome along with key details such as the UTR, payment type, and merchant reference ID.

Quick ReferenceMethod: POSTRequired: transaction_id (UUID from Initiate PayIn)Returns: payment_status, utr, payment_type, merchant_ref_id, amountTip: Prefer webhooks over polling for production traffic.

Endpoint

POST https://api.fastflowpe.com/merchant/payin/status

Headers

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

Request Body Parameters

string

required

The UUID of the transaction to look up. This is the transaction_id returned by the Initiate PayIn endpoint.

curl --location 'https://api.fastflowpe.com/merchant/payin/status' \
--header 'x-api-key: <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{"transaction_id": "e7a1c22d-52cb-419b-af0c-122c16c5b613"}'

import requests

url = "https://api.fastflowpe.com/merchant/payin/status"
headers = {
    "x-api-key": "<your-api-key>",
    "Content-Type": "application/json",
}
payload = {"transaction_id": "e7a1c22d-52cb-419b-af0c-122c16c5b613"}

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

const response = await fetch("https://api.fastflowpe.com/merchant/payin/status", {
  method: "POST",
  headers: {
    "x-api-key": "<your-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ transaction_id: "e7a1c22d-52cb-419b-af0c-122c16c5b613" }),
});
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/status"))
    .header("x-api-key", "<your-api-key>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"transaction_id\": \"e7a1c22d-52cb-419b-af0c-122c16c5b613\"}"))
    .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": "e7a1c22d-52cb-419b-af0c-122c16c5b613"}`)
    req, _ := http.NewRequest("POST", "https://api.fastflowpe.com/merchant/payin/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/status");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["transaction_id" => "e7a1c22d-52cb-419b-af0c-122c16c5b613"]));
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/status')
request = Net::HTTP::Post.new(uri)
request['x-api-key'] = '<your-api-key>'
request['Content-Type'] = 'application/json'
request.body = { transaction_id: 'e7a1c22d-52cb-419b-af0c-122c16c5b613' }.to_json

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

Responses

{
  "status": "success",
  "status_code": 200,
  "message": "Transaction status retrieved successfully",
  "detail": "Status check completed successfully",
  "data": {
    "transaction_id": "<Transaction UUID>",
    "status": "SUCCESS",
    "utr": "<Unique Transaction Reference>",
    "payment_details": "<Payment details object>",
    "amount": "<Transaction amount in float>",
    "payment_type": "<Payment type>",
    "merchant_ref_id": "<Merchant reference ID>"
  },
  "meta": null
}

{
  "status": "success",
  "status_code": 200,
  "message": "Transaction status retrieved successfully",
  "detail": "Status check completed successfully",
  "data": {
    "transaction_id": "<Transaction UUID>",
    "status": "FAILED",
    "utr": null,
    "payment_details": "<Payment details object>",
    "amount": "<Transaction amount in float>",
    "payment_type": "<Payment type>",
    "merchant_ref_id": "<Merchant reference ID>"
  },
  "meta": null
}

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

Response Fields

string

The UUID of the transaction, matching the value you submitted in the request body.

string

Outcome of the transaction. Possible values: SUCCESS, FAILED, PENDING.

string

Unique Transaction Reference assigned by the banking network upon successful payment. Returns null for failed or pending transactions.

float

The transaction amount in Indian Rupees.

string

The payment method used for the transaction (e.g. QR, INTENT, DEBIT_CARD).

string

Your original order_id, returned as a reference so you can reconcile the transaction against your system records.

If you do not use webhooks, poll this endpoint after initiating a PayIn to confirm the final payment status. We recommend polling at a reasonable interval (e.g. every 5 seconds) until you receive a terminal state of SUCCESS or FAILED.

⌘I

curl --location 'https://api.fastflowpe.com/merchant/payin/status' \
--header 'x-api-key: <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{"transaction_id": "e7a1c22d-52cb-419b-af0c-122c16c5b613"}'

import requests

url = "https://api.fastflowpe.com/merchant/payin/status"
headers = {
    "x-api-key": "<your-api-key>",
    "Content-Type": "application/json",
}
payload = {"transaction_id": "e7a1c22d-52cb-419b-af0c-122c16c5b613"}

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

const response = await fetch("https://api.fastflowpe.com/merchant/payin/status", {
  method: "POST",
  headers: {
    "x-api-key": "<your-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ transaction_id: "e7a1c22d-52cb-419b-af0c-122c16c5b613" }),
});
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/status"))
    .header("x-api-key", "<your-api-key>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"transaction_id\": \"e7a1c22d-52cb-419b-af0c-122c16c5b613\"}"))
    .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": "e7a1c22d-52cb-419b-af0c-122c16c5b613"}`)
    req, _ := http.NewRequest("POST", "https://api.fastflowpe.com/merchant/payin/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/status");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["transaction_id" => "e7a1c22d-52cb-419b-af0c-122c16c5b613"]));
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/status')
request = Net::HTTP::Post.new(uri)
request['x-api-key'] = '<your-api-key>'
request['Content-Type'] = 'application/json'
request.body = { transaction_id: 'e7a1c22d-52cb-419b-af0c-122c16c5b613' }.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": "Transaction status retrieved successfully",
  "detail": "Status check completed successfully",
  "data": {
    "transaction_id": "<Transaction UUID>",
    "status": "SUCCESS",
    "utr": "<Unique Transaction Reference>",
    "payment_details": "<Payment details object>",
    "amount": "<Transaction amount in float>",
    "payment_type": "<Payment type>",
    "merchant_ref_id": "<Merchant reference ID>"
  },
  "meta": null
}

{
  "status": "success",
  "status_code": 200,
  "message": "Transaction status retrieved successfully",
  "detail": "Status check completed successfully",
  "data": {
    "transaction_id": "<Transaction UUID>",
    "status": "FAILED",
    "utr": null,
    "payment_details": "<Payment details object>",
    "amount": "<Transaction amount in float>",
    "payment_type": "<Payment type>",
    "merchant_ref_id": "<Merchant reference ID>"
  },
  "meta": null
}

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

Get Started

Collections

Payment Links

Fund Transfer

Refunds

Callbacks

Check PayIn Transaction Status

Endpoint

Headers

Request Body Parameters

Responses

Response Fields

​Endpoint

​Headers

​Request Body Parameters

​Responses

​Response Fields

Endpoint

Headers

Request Body Parameters

Responses

Response Fields