Skip to main content

Payments

A payment initiates collection against an accepted Flow A quote. For live traffic use Transactions (Flow B). Idempotency-Key required.

Flow A — sandbox only

POST /v1/payments is gated to TEST keys. LIVE keys are rejected. Production integrations must use Flow B transactions.

Create​

PAYMENT_ID=$(curl -s -X POST "$BASE_URL/v1/payments" \
  -H "X-API-Key: $THIQWAVE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "'"$QUOTE_ID"'",
    "collection_method": "LEAN_OPEN_BANKING"
  }' | jq -r .id)
FieldRequiredNotes
quote_idyesUUID of an accepted Flow A quote
collection_methodyesLEAN_OPEN_BANKING | VIRTUAL_IBAN

Same Idempotency-Key + same quote_id → original payment; different quote_id → 409 IDM_0001.

Get / List​

curl "$BASE_URL/v1/payments/$PAYMENT_ID" -H "X-API-Key: $THIQWAVE_API_KEY"
curl "$BASE_URL/v1/payments?limit=20"    -H "X-API-Key: $THIQWAVE_API_KEY"

Filters: status, from_date, to_date (ISO 8601), limit, cursor. Prefer Webhooks.

Next steps​