API V1 (legacy)

Transaction tracking (V1)

List the token's transactions, get aggregated statistics and verify a transaction with LabPay.

You are reading the legacy V1, maintained for existing integrations. For a new integration, use V2; to migrate, see Versions and migration.

List transactions#

GET `/V1/payment/get-transactions`#

All of the token's live transactions (including those made with V2), with their status and provider. No pagination nor guaranteed order: sort client-side (by created_at).

Field	Type	Required	Description
`token`	string	Yes	Your API token (query string, encoded).
`status`	string	No	Status name: `processed`, `pending`, `done`, `failed`, `canceled`.
`nature`	string	No	`1` collection, `2` withdrawal, `3` refund (V2).
`currency`	string	No	`CDF` \| `USD`
`year`, `month`, `week`	integer	No	Year (`YYYY`), month (1–12), ISO week.
`date`	string	No	Exact day, `YYYY-MM-DD`.
`hour`	integer	No	Hour (1–23).

Completed USD transactions

curl "https://api.labyrinthe-rdc.com/api/V1/payment/get-transactions?token=VOTRE_TOKEN&status=done&currency=USD" \
  -H "Accept: application/json"

Response: V1 envelope, list in results.details.

Statistics#

GET `/V1/payment/get-transactions/stats`#

Count and sum of amounts (amountCustomer) of transactions, grouped by currency, status, nature and day. Filters: token (required), status, nature, currency, year, month, date.

results.details.global_summary: per currency, total and breakdown by status.
stats_by_currency, stats_by_status, stats_by_date, stats_by_nature: total_count, total_amount and a breakdown on a second dimension.
Numbers may arrive as strings or numbers: convert them before computing.

Statistics for the year

curl "https://api.labyrinthe-rdc.com/api/V1/payment/get-transactions/stats?token=VOTRE_TOKEN&year=2026" \
  -H "Accept: application/json"

Verify a transaction#

POST `/V1/payment/verify`#

Field	Type	Required	Description
`token`	string	Yes	Your API token.
`reference`	string	Yes	`reference` of a transaction of this token (UUID returned at initiation).

Queries LabPay about the transaction; its raw answer is returned in results.details. Reference of another merchant or unknown: 403; call failure: 400.

Verify

curl -X POST "https://api.labyrinthe-rdc.com/api/V1/payment/verify" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"token":"VOTRE_TOKEN","reference":"6f1d2c3b-8a7e-4f10-9b2c-3d4e5f607182"}'