Skip to main content

​
Initiate POS Transaction

This endpoint allows a user to create and send a transaction to a POS terminal. 
curl -X POST 'https://developers.flouci.com/api/transactions/init_pos_transaction' \
  -H 'Authorization: Bearer <APP_PUBLIC>:<APP_SECRET>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id_terminal": "terminal",
    "serial_number": "SN123456",
    "amount_in_millimes": 1000,
    "payment_method": "WALLET",
    "developer_tracking_id": "dev_track_123"
  }'

​
Body

​
id_terminal
string
required
Unique identifier of the POS terminal.
​
serial_number
string
required
Serial number of the POS terminal.
​
amount_in_millimes
integer
required
Transaction amount in millimes.
​
payment_method
string
required
Payment method (NFC, CARD, WALLET, CHECK).
​
developer_tracking_id
string
required
An ID for you to track the payment. This is a free field that Flouci doesn’t check against
​
webhook
string
Webhook URL to notify transaction status.
{
  "success": true,
  "terminal_id": "testing1234",
  "status_code": 201
}

​
Get POS Transaction Status

This endpoint retrieves the status of a POS transaction. 
curl -X GET 'https://developers.flouci.com/api/transactions/get_pos_transaction_status?developer_tracking_id=dev_track_123' \
  -H 'Authorization: Bearer <APP_PUBLIC>:<APP_SECRET>'

​
Query Parameters

​
flouci_transaction_id
uuid
Unique transaction ID from Flouci.
​
developer_tracking_id
string
An ID for you to track the payment. This is a free field that Flouci doesn’t check against
{
  "success": true,
  "transactions": [
    {
      "developer_tracking_id": "7cd66b29-a8b7-4e4c-aedf-0d98eeb92703",
      "payment_status": "PS",
      "transaction_id": "1b7b29df-6826-4b33-b5a6-fb86fcc15e5c"
    }
  ],
  "status_code": 200
}