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

curl --request POST 'https://api.fastflowpe.com/merchant/recurring/subscription/payment/status' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY' \
  --data-raw '{
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "Subscription payment status fetched successfully",
  "detail": null,
  "data": {
    "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "payment_status": "SUCCESS",
    "payment_type": "CHARGE",
    "payment_amount": 1000,
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "utr": "123456789012"
  },
  "meta": null
}

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

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

{
  "status": "error",
  "status_code": 400,
  "message": "PSP transaction ID not available for this transaction",
  "detail": null,
  "data": null,
  "meta": null
}

Use the internal FastFlowPe subscription_id and transaction_id. Both values must be valid UUIDs. Use the API key in the x-api-key header. Do not send it in the Authorization header.

Quick ReferenceRequired: subscription_id, transaction_idReturns: payment_status, payment_type, payment_amount, utrMethod: POST

Endpoint Details

Field	Value
Method	`POST`
Payload	`JSON`
URL	`https://api.fastflowpe.com/merchant/recurring/subscription/payment/status`

Request Headers

string

required

Your secret merchant API key issued by FastFlowPe.

string

required

Must be application/json.

Request Body

string

required

Internal FastFlowPe subscription UUID.This must be a valid UUID.Example:550e8400-e29b-41d4-a716-446655440000

string

required

Internal FastFlowPe transaction UUID associated with the subscription.This must be a valid UUID.Example:7c9e6679-7425-40de-944b-e07fc1f90ae7

Request Example

curl --request POST 'https://api.fastflowpe.com/merchant/recurring/subscription/payment/status' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY' \
  --data-raw '{
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }'

Response

A successful request returns the current payment status for the specified subscription transaction.

{
  "status": "success",
  "status_code": 200,
  "message": "Subscription payment status fetched successfully",
  "detail": null,
  "data": {
    "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "payment_status": "SUCCESS",
    "payment_type": "CHARGE",
    "payment_amount": 1000,
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "utr": "123456789012"
  },
  "meta": null
}

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

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

{
  "status": "error",
  "status_code": 400,
  "message": "PSP transaction ID not available for this transaction",
  "detail": null,
  "data": null,
  "meta": null
}

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 payment status request.

object

Additional response details when available.This may be null.

string

Internal FastFlowPe transaction UUID.

string

Current status of the subscription payment.Possible values may include:

SUCCESS
FAILED
PENDING

string

Identifies the purpose of the payment.Example: CHARGE

number

Amount associated with the subscription payment transaction.

string

Internal FastFlowPe subscription UUID associated with the transaction.

string

UTR or payment reference returned for the payment.This field may be null.

object

Optional response metadata.This may be null.

Payment Status Values

Status	Meaning
`SUCCESS`	Subscription payment completed successfully.
`FAILED`	Subscription payment failed.
`PENDING`	Subscription payment is still awaiting a final status.

Common Errors

Subscription Not Found

Returned when the supplied subscription_id does not exist or does not belong to the authenticated merchant. HTTP 404:

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

Transaction Not Found

Returned when the supplied transaction does not exist for the specified subscription. HTTP 404:

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

PSP Transaction ID Not Available

Returned when the FastFlowPe transaction exists but does not have the PSP transaction identifier required to perform a payment status check. HTTP 400:

{
  "status": "error",
  "status_code": 400,
  "message": "PSP transaction ID not available for this transaction",
  "detail": null,
  "data": null,
  "meta": null
}

The transaction_id must belong to the specified subscription_id.Use the internal FastFlowPe transaction ID, not a PSP transaction ID.

You can retrieve subscription transaction IDs from the subscription transactions API and then use this endpoint to check the latest payment status for a specific transaction.

curl --request POST 'https://api.fastflowpe.com/merchant/recurring/subscription/payment/status' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_MERCHANT_X_API_KEY' \
  --data-raw '{
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "Subscription payment status fetched successfully",
  "detail": null,
  "data": {
    "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "payment_status": "SUCCESS",
    "payment_type": "CHARGE",
    "payment_amount": 1000,
    "subscription_id": "550e8400-e29b-41d4-a716-446655440000",
    "utr": "123456789012"
  },
  "meta": null
}

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

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

{
  "status": "error",
  "status_code": 400,
  "message": "PSP transaction ID not available for this transaction",
  "detail": null,
  "data": null,
  "meta": null
}

Get Started

Collections

Payment Links

Fund Transfer

Refunds

Callbacks

subscription

Check Subscription Payment Status

Endpoint Details

Request Headers

Request Body

Request Example

Response

Response Fields

Payment Status Values

Common Errors

Subscription Not Found

Transaction Not Found

PSP Transaction ID Not Available

​Endpoint Details

​Request Headers

​Request Body

​Request Example

​Response

​Response Fields

​Payment Status Values

​Common Errors

​Subscription Not Found

​Transaction Not Found

​PSP Transaction ID Not Available

Endpoint Details

Request Headers

Request Body

Request Example

Response

Response Fields

Payment Status Values

Common Errors

Subscription Not Found

Transaction Not Found

PSP Transaction ID Not Available