BARQ (In/Out)

Transfer via phone number (9 digits).


CountrySaudi Arabia
CurrencySAR (Saudi riyal)
Method typebarq
DirectionPayIn/PayOut
Integration typeWidget/H2H
Transfer typeTransfer via mobile number
Account number format9-digit mobile number
Limits*********

Create Pay-in (API request)
Integration type: Widget/H2H
HTTP Method: POST
Endpoint: /deals/payin

{
  "amount": 1000,                              // Payment amount
  "currency": "SAR",                           // Currency
  "invoiceId": "invoiceID",                    // Unique invoice identifier on the merchant side
  "clientId": "clientID",                      // Unique client identifier on the merchant side
  "type": "barq",                              // Method type
  "backUrl": "https://www.google.com/",        // Optional (widget): URL for return without                                                             completing payment
  "lang": "EN"                                 // Optional (widget): localization EN/AR
}

Create Payout (API request)
Integration type: H2H
HTTP Method: POST
Endpoint: /deals/payout

{
  "amount": 1000,                               // Payout amount
  "currencyTo": "SAR",                          // Currency
  "clientId": "clientID",                       // Unique client identifier on the merchant side
  "recipient": {                                // Recipient information
    "account_number": "01234567890",            // Mobile number linked to recipient's account
    "account_owner": "Account Holder",          // Recipient's full name (account holder)
    "type": "phone"                             // Recipient account type
  },
  "type": "barq",                               // Method type
}

API Documentation


Did this page help you?