LabPay documentationAPI V2 · V1

API V1 (legacy)

Withdraw to a wallet (V1)

POST /V1/payment/withdrawal: send money from your balance to a Mobile Money wallet in DR Congo.

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

POST /V1/payment/withdrawal#

Parameters#

FieldTypeRequiredDescription
tokenstringYesYour API token.
amountnumberYesAmount to send, ≥ 0, at most the available balance in that currency.
currencystringYesCDF | USD
phonestringYesRecipient number in local format, exactly 10 characters.
callbackstringNoURL that will receive the result (see Callbacks).

Recognised prefixes:

  • Vodacom M-Pesa: 081, 082, 083
  • Orange Money: 080, 084, 085, 089
  • Airtel Money: 097, 098, 099

Withdraw 50 USD

curl -X POST "https://api.labyrinthe-rdc.com/api/V1/payment/withdrawal" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"token":"VOTRE_TOKEN","amount":50,"currency":"USD","phone":"0812345678","callback":"https://boutique.example/callback"}'

How it works#

  • Checks: an account exists in that currency and amount does not exceed its balance (otherwise 400), caps of 20,000,000 CDF and 10,000 USD, token not blocked, recognised number.
  • No fee is charged on a V1 withdrawal.
  • Your balance is debited with amount when LabPay confirms the withdrawal, not at initiation.

The 200 response carries the done status ("La transaction a été effectuée avec succès") right at initiation: it only means the request was accepted. Wait for the callback, or check with verify, before treating the withdrawal as completed.

LabPay refusal: 400 "Le retrait a échoué." (see Errors).