API V1 (legacy)

Cross-network transfer (V1)

POST /V1/payment/inter-transfer: move funds between the wallets of two Mobile Money networks on the LabPay network (V1).

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/inter-transfer#

Networks are inferred from both numbers. If both numbers are on the same network, nothing is done and the response is a success.

Parameters#

FieldTypeRequiredDescription
tokenstringYesYour API token (active).
amountnumberYesAmount, > 0, at most your balance in that currency.
currencystringYesCDF | USD
from_phonestringYesSource network number, 10 characters.
to_phonestringYesTarget network number, 10 characters.
from_action, to_actionstringYesPassed as is to LabPay.
notestringNoFree note.

The expected values of from_action and to_action depend on the LabPay V1 configuration: ask support for them before using this endpoint.

M-Pesa → Airtel transfer

curl -X POST "https://api.labyrinthe-rdc.com/api/V1/payment/inter-transfer" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"token":"VOTRE_TOKEN","amount":100,"currency":"USD","from_phone":"0812345678","to_phone":"0991234567","from_action":"…","to_action":"…"}'

Responses#

  • 200 "La transfert a été effectué avec succès.": results.status is true, results.details the LabPay answer (empty for the same network).
  • 400: missing account, amount above balance, unrecognised number or currency, or "Le transfert a échoué.".
  • 403: validation (errors) or inactive token; 500: unexpected answer.