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

curl --request GET \
  --url 'https://api.fastflowpe.com/merchant/recurring/subscription/YOUR_SUBSCRIPTION_UUID/latest-transaction' \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY'

{
  "status": "success",
  "status_code": 200,
  "message": "Latest cycle transaction fetched successfully",
  "detail": null,
  "data": {
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "cycle_number": 3,
    "attempt_number": 2,
    "billing_period": "2026-10-01",
    "transaction_id": "8d727851-a14e-46ea-aee4-e0fd9ca915bb",
    "amount": "499.00",
    "status": "FAILED",
    "failure_code": "PAYMENT_DECLINED",
    "remark": "Payment declined by the issuing bank",
    "created_at": "2026-10-04T12:30:15.124000"
  },
  "meta": null
}

{
  "status": "success",
  "status_code": 200,
  "message": "All cycles are successful. No pending or failed cycle found.",
  "detail": null,
  "data": null,
  "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_idReturns: Latest transaction attempt for the highest-numbered cycle whose status is not SUCCESSMethod: GET

Endpoint Details

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

Request Headers

string

required

Your 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

Request Example

curl --request GET \
  --url 'https://api.fastflowpe.com/merchant/recurring/subscription/YOUR_SUBSCRIPTION_UUID/latest-transaction' \
  --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.

Response

The API returns the latest transaction attempt for the highest-numbered subscription cycle whose status is not SUCCESS.

{
  "status": "success",
  "status_code": 200,
  "message": "Latest cycle transaction fetched successfully",
  "detail": null,
  "data": {
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "cycle_number": 3,
    "attempt_number": 2,
    "billing_period": "2026-10-01",
    "transaction_id": "8d727851-a14e-46ea-aee4-e0fd9ca915bb",
    "amount": "499.00",
    "status": "FAILED",
    "failure_code": "PAYMENT_DECLINED",
    "remark": "Payment declined by the issuing bank",
    "created_at": "2026-10-04T12:30:15.124000"
  },
  "meta": null
}

{
  "status": "success",
  "status_code": 200,
  "message": "All cycles are successful. No pending or failed cycle found.",
  "detail": null,
  "data": null,
  "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 API 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 details when available.This may be null.

string

Internal FastFlowPe subscription UUID.

integer

Highest-numbered subscription cycle that is not currently successful.

integer

Latest transaction attempt number for the selected cycle.

string

Billing period associated with the subscription cycle.Example: 2026-10-01

string

Unique FastFlowPe transaction ID for the latest transaction attempt.

string

Transaction amount for the recurring payment attempt.

string

Current status of the transaction attempt.Example: FAILED

string

Failure code associated with the recurring transaction.This may be null when no failure code exists.

string

Human-readable remark describing the transaction result.

string

Timestamp when the transaction attempt was created.

object

Optional response metadata.This may be null.

All Cycles Successful

If all subscription cycles have status SUCCESS, the API returns HTTP 200 with data set to null.

{
  "status": "success",
  "status_code": 200,
  "message": "All cycles are successful. No pending or failed cycle found.",
  "detail": null,
  "data": null,
  "meta": 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 API selects the highest-numbered subscription cycle whose status is not SUCCESS, then returns the latest transaction attempt for that cycle.

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 this endpoint when you need the most recent pending or failed recurring payment attempt without fetching the complete transaction history.

curl --request GET \
  --url 'https://api.fastflowpe.com/merchant/recurring/subscription/YOUR_SUBSCRIPTION_UUID/latest-transaction' \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY'

{
  "status": "success",
  "status_code": 200,
  "message": "Latest cycle transaction fetched successfully",
  "detail": null,
  "data": {
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "cycle_number": 3,
    "attempt_number": 2,
    "billing_period": "2026-10-01",
    "transaction_id": "8d727851-a14e-46ea-aee4-e0fd9ca915bb",
    "amount": "499.00",
    "status": "FAILED",
    "failure_code": "PAYMENT_DECLINED",
    "remark": "Payment declined by the issuing bank",
    "created_at": "2026-10-04T12:30:15.124000"
  },
  "meta": null
}

{
  "status": "success",
  "status_code": 200,
  "message": "All cycles are successful. No pending or failed cycle found.",
  "detail": null,
  "data": null,
  "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 Latest Subscription Transaction

Endpoint Details

Request Headers

Path Parameters

Request Example

Response

Response Fields

All Cycles Successful

Subscription Not Found

Authentication Error

​Endpoint Details

​Request Headers

​Path Parameters

​Request Example

​Response

​Response Fields

​All Cycles Successful

​Subscription Not Found

​Authentication Error

Endpoint Details

Request Headers

Path Parameters

Request Example

Response

Response Fields

All Cycles Successful

Subscription Not Found

Authentication Error