FastFlowPe is a payment orchestration platform. This documentation covers integration of our unified API for payments and payouts, SDKs, and workflows

curl --request GET \
  'https://api.fastflowpe.com/merchant/recurring/subscription/YOUR_SUBSCRIPTION_UUID/transactions?limit=20&page_no=1' \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY'

{
  "status": "success",
  "status_code": 200,
  "message": "Subscription transactions fetched successfully",
  "detail": null,
  "data": {
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "transactions": [
      {
        "transaction_id": "a21d82fc-41a3-4eb8-987e-612b5cb29a12",
        "cycle_number": 2,
        "attempt_number": 1,
        "amount": "499.00",
        "status": "SUCCESS",
        "failure_code": null,
        "remark": "Recurring payment completed",
        "created_at": "2026-10-04T11:25:42.123456"
      }
    ],
    "pagination": {
      "limit": 20,
      "has_next": true,
      "total_pages": 3,
      "page_no": 1,
      "next_cursor": {
        "cursor_id": "a21d82fc-41a3-4eb8-987e-612b5cb29a12"
      }
    }
  },
  "meta": null
}

{
  "status": "error",
  "status_code": 404,
  "message": "Subscription not found",
  "detail": null,
  "data": null,
  "meta": null
}

{
  "detail": "No authorization/ x-api-key header provided."
}

Use the internal subscription_id returned by the subscription initialize API. Use the API key in the x-api-key header. Do not send it in the Authorization header.

Quick ReferenceRequired: subscription_idOptional Query Parameters: limit, page_no, cursor_idReturns: Subscription transactions and pagination detailsMethod: GET

Endpoint Details

Field	Value
Method	`GET`
Request Body	None
URL	`https://api.fastflowpe.com/merchant/recurring/subscription/{subscription_id}/transactions`

Request Headers

string

required

Your secret merchant API key issued by FastFlowPe.

string

required

Must be application/json.

Path Parameters

string

required

Internal FastFlowPe subscription UUID returned by the subscription initialize API.Example:550e8400-e29b-41d4-a716-446655440000

Query Parameters

integer

Number of transactions to return.Default: 20Minimum: 1Maximum: 100

integer

Page number used for page-based pagination.Default: 1Minimum: 1

string

Transaction ID used for cursor-based pagination.Use the cursor_id returned in pagination.next_cursor.

If both page_no and cursor_id are provided, page_no takes precedence.

Request Example

curl --request GET \
  'https://api.fastflowpe.com/merchant/recurring/subscription/YOUR_SUBSCRIPTION_UUID/transactions?limit=20&page_no=1' \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY'

Replace YOUR_SUBSCRIPTION_UUID with the internal subscription_id returned by /merchant/recurring/subscription/initialize.

Cursor Pagination Request

Use the cursor_id returned in pagination.next_cursor to fetch the next set of transactions.

curl --request GET \
  'https://api.fastflowpe.com/merchant/recurring/subscription/YOUR_SUBSCRIPTION_UUID/transactions?limit=20&cursor_id=YOUR_CURSOR_ID' \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY'

Response

A successful request returns the transactions associated with the subscription along with pagination details.

{
  "status": "success",
  "status_code": 200,
  "message": "Subscription transactions fetched successfully",
  "detail": null,
  "data": {
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "transactions": [
      {
        "transaction_id": "a21d82fc-41a3-4eb8-987e-612b5cb29a12",
        "cycle_number": 2,
        "attempt_number": 1,
        "amount": "499.00",
        "status": "SUCCESS",
        "failure_code": null,
        "remark": "Recurring payment completed",
        "created_at": "2026-10-04T11:25:42.123456"
      }
    ],
    "pagination": {
      "limit": 20,
      "has_next": true,
      "total_pages": 3,
      "page_no": 1,
      "next_cursor": {
        "cursor_id": "a21d82fc-41a3-4eb8-987e-612b5cb29a12"
      }
    }
  },
  "meta": null
}

{
  "status": "error",
  "status_code": 404,
  "message": "Subscription not found",
  "detail": null,
  "data": null,
  "meta": null
}

{
  "detail": "No authorization/ x-api-key header provided."
}

Response Fields

string

Indicates whether the request succeeded or failed.

integer

HTTP-style status code associated with the response.

string

Human-readable message describing the result of the request.

object

Additional response information when available.This may be null.

string

Internal FastFlowPe subscription UUID whose transactions were requested.

array

List of recurring payment transactions associated with the subscription.

string

Unique FastFlowPe transaction ID for the recurring payment attempt.

integer

Billing cycle number associated with the transaction.

integer

Attempt number for the transaction within the billing cycle.

string

Amount associated with the recurring transaction.

string

Current status of the recurring transaction.Example: SUCCESS

string

Failure code returned when the recurring transaction fails.This may be null for successful transactions.

string

Human-readable remark describing the recurring transaction result.

string

Timestamp when the transaction record was created.

object

Pagination information for the transaction list.

integer

Maximum number of transactions requested for the current response.

boolean

Indicates whether more transactions are available.

integer

Total number of available pages.

integer

Current page number when page-based pagination is used.This value is null when cursor-based pagination is used.

object

Cursor information used to fetch the next set of transactions.This value is null when no additional transactions are available.

string

Transaction ID to pass as cursor_id in the next cursor-based pagination request.

object

Optional response metadata.This may be null.

Cursor Pagination Response

When cursor-based pagination is used, page_no is returned as null.

{
  "pagination": {
    "limit": 20,
    "has_next": false,
    "total_pages": 3,
    "next_cursor": null,
    "page_no": null
  }
}

Subscription Not Found

If the subscription does not exist or does not belong to the authenticated merchant, the API returns HTTP 404.

{
  "status": "error",
  "status_code": 404,
  "message": "Subscription not found",
  "detail": null,
  "data": null,
  "meta": null
}

Authentication Error

If the x-api-key header is not provided, the API returns HTTP 401.

{
  "detail": "No authorization/ x-api-key header provided."
}

The subscription must belong to the merchant associated with the supplied x-api-key.If the subscription belongs to another merchant, it is returned as not found.

Use page-based pagination for simple page navigation. Use cursor_id when you want to continue fetching transactions from the last returned transaction.

curl --request GET \
  'https://api.fastflowpe.com/merchant/recurring/subscription/YOUR_SUBSCRIPTION_UUID/transactions?limit=20&page_no=1' \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY'

{
  "status": "success",
  "status_code": 200,
  "message": "Subscription transactions fetched successfully",
  "detail": null,
  "data": {
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "transactions": [
      {
        "transaction_id": "a21d82fc-41a3-4eb8-987e-612b5cb29a12",
        "cycle_number": 2,
        "attempt_number": 1,
        "amount": "499.00",
        "status": "SUCCESS",
        "failure_code": null,
        "remark": "Recurring payment completed",
        "created_at": "2026-10-04T11:25:42.123456"
      }
    ],
    "pagination": {
      "limit": 20,
      "has_next": true,
      "total_pages": 3,
      "page_no": 1,
      "next_cursor": {
        "cursor_id": "a21d82fc-41a3-4eb8-987e-612b5cb29a12"
      }
    }
  },
  "meta": null
}

{
  "status": "error",
  "status_code": 404,
  "message": "Subscription not found",
  "detail": null,
  "data": null,
  "meta": null
}

{
  "detail": "No authorization/ x-api-key header provided."
}

Get Started

Collections

Payment Links

Fund Transfer

Refunds

Callbacks

subscription

Get Subscription Transactions

Endpoint Details

Request Headers

Path Parameters

Query Parameters

Request Example

Response

Response Fields

Subscription Not Found

Authentication Error

​Endpoint Details

​Request Headers

​Path Parameters

​Query Parameters

​Request Example

​Cursor Pagination Request

​Response

​Response Fields

​Cursor Pagination Response

​Subscription Not Found

​Authentication Error

Endpoint Details

Request Headers

Path Parameters

Query Parameters

Request Example

Cursor Pagination Request

Response

Response Fields

Cursor Pagination Response

Subscription Not Found

Authentication Error