Get POS Transaction Status

curl -X GET 'https://developers.flouci.com/partners/transactions/get_pos_transaction_status?developer_tracking_id=dev_track_123' \
  -H 'Authorization: Bearer <APP_PUBLIC>:<APP_SECRET>'

{
  "success": true,
  "transactions": [
    {
      "developer_tracking_id": "7cd66b29-a8b7-4e4c-aedf-0d98eeb92703",
      "flouci_transaction_id": "1b7b29df-6826-4b33-b5a6-fb86fcc15e5c",
      "payment_status": "PS",
      "payment_method": "card",
      "amount_in_millimes": 50000,
      "currency": "TND",
      "terminal_id": "T001",
      "settlement_status": "AVAILABLE"
    }
  ],
  "status_code": 200
}

This endpoint retrieves the status of a POS transaction.

curl -X GET 'https://developers.flouci.com/partners/transactions/get_pos_transaction_status?developer_tracking_id=dev_track_123' \
  -H 'Authorization: Bearer <APP_PUBLIC>:<APP_SECRET>'

Query Parameters

uuid

Unique transaction ID from Flouci. Mutually exclusive with developer_tracking_id.

string

An ID for you to track the payment. This is a free field that Flouci doesn’t check against. May return multiple rows if you reused the same tracking ID.

string

Optional terminal identifier to narrow the lookup to a single terminal.

{
  "success": true,
  "transactions": [
    {
      "developer_tracking_id": "7cd66b29-a8b7-4e4c-aedf-0d98eeb92703",
      "flouci_transaction_id": "1b7b29df-6826-4b33-b5a6-fb86fcc15e5c",
      "payment_status": "PS",
      "payment_method": "card",
      "amount_in_millimes": 50000,
      "currency": "TND",
      "terminal_id": "T001",
      "settlement_status": "AVAILABLE"
    }
  ],
  "status_code": 200
}

Response Fields

string

Your merchant-supplied reference. May be null.

string

required

Unique POS transaction identifier from Flouci.

string

required

POS payment status code: PS (succeeded), PP (pending), PF (failed), PR (refunded), RP (refund pending), RF (refund failed), PU (unknown), PA (authorized).

string

required

One of card, wallet, nfc, check, or cash.

integer

required

Transaction amount in millimes.

string

required

Currency code. Currently always TND.

string

Identifier of the terminal that processed the transaction. May be null.

string

required

Settlement lifecycle state for this transaction. For POS, possible values are PROCESSING (auth pending), AVAILABLE (settled into your wallet), or NOT_APPLICABLE (failed / refunded). POS transactions never reach IN_PAYOUT or PAID — they settle directly into your Flouci wallet rather than entering the card payout pipeline. See Settlement Status for the full reference.

In test mode, NFC mock responses do not include settlement_status. Production responses always include it.

Introduction

Basic Payment Flows

Advanced payment flows

Partner APIs

Payment Plugins

Business Dashboard

Environments

Changelog

Query Parameters

Response Fields

​Query Parameters

​Response Fields

Query Parameters

Response Fields