Transfers

Initiate and manage money transfers between BaridiMob accounts.

Two-Step Process

Transfers require two steps: initiation (sends OTP to phone) and confirmation with OTP.

POST

/sdk/mobilebank/accounts/{rip}/transfer/initiate

Start a new transfer. This will send an OTP to the account holder's phone.

Path Parameters

Parameter Type Description
rip string (20 digits) Source account RIP (sender)

Request Body

{
  "target_rip": "00799999009876543210",
  "amount": "5000"
}

Parameters

Field Type Required Description
target_rip string Yes 20-digit RIP of the recipient
amount string Yes Amount in DZD (whole number as string)

Response

{
  "success": true,
  "message": "OTP sent successfully.",
  "message_ar": "تم إرسال رمز التحقق بنجاح.",
  "data": {
    "trans_ref": "TRF20251205143022ABC",
    "amount": "5000",
    "target_rip": "00799999009876543210"
  }
}

Your API key is saved locally in your browser.

rip
target_rip
amount
POST
POST

/sdk/mobilebank/accounts/{rip}/transfer/confirm

Confirm a pending transfer using the OTP received via SMS.

Request Body

{
  "trans_ref": "TRF20251205143022ABC",
  "otp": "123456",
  "target_rip": "00799999009876543210",
  "amount": "5000"
}

Parameters

Field Type Required Description
trans_ref string Yes Transaction reference from initiate step
otp string Yes 6-digit OTP received via SMS
target_rip string Yes Same target RIP from initiate
amount string Yes Same amount from initiate

Response

{
  "success": true,
  "message": "Transfer completed successfully.",
  "message_ar": "تم التحويل بنجاح.",
  "data": {
    "reference": "009593752595",
    "amount": "5000",
    "target_rip": "00799999009876543210",
    "timestamp": "2025-12-05T14:32:15+00:00"
  }
}

Your API key is saved locally in your browser.

rip
trans_ref
otp
target_rip
amount
POST

Common Errors

Error Code Description
ACCOUNT_NOT_FOUND The source account RIP was not found
ACCOUNT_INACTIVE The account is inactive
PRIVATE_KEY_REQUIRED Account needs private key for transfers
INVALID_OTP The OTP code is incorrect or expired
TRANSFER_FAILED Transfer failed (insufficient balance, etc.)
Transactions Error Codes