Skip to main content

Transactions — Reference

Auth: X-API-Key.

POST /v1/transactions — create · Idempotency-Key required​

curl -X POST "$BASE_URL/v1/transactions" \
  -H "X-API-Key: $THIQWAVE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "'"$QUOTE_ID"'",
    "beneficiary_id": "'"$BENEFICIARY_ID"'"
  }'
FieldTypeRequiredNotes
quote_idstringyesACCEPTED, unused Flow B quote
beneficiary_idstringyespayout destination

Response 201 returns the transaction (id, external_id txn_…, state, amounts as minor-unit strings). Errors: 400 IDM_0002 (missing key) / quote not accepted, 404, 409 IDM_0001.

GET /v1/transactions/:id​

Errors: 404 TXN_0001.

GET /v1/transactions​

Query: limit, cursor. Response: { "data": [...], "pagination": { "has_more", "next_cursor" } }.