BenefitPay (in/out)

Transfer via BenefitPay (mobile number).


CountryBahrain
CurrencyBHD (Bahraini dinar)
Method typeBenefitPay
DirectionPay-in/Payout
Integration typeWidget/H2H
Transfer type**Transfer via mobile phone **
Account number format8 - 11 digits mobile number
Limits

Create Pay-in (API request):

Integration type: Widget/H2H HTTP Method: POST Endpoint: /deals/payin

{
  "amount": 1000,                              // Payment amount
  "currency": "BHD",                           // Currency
  "invoiceId": "invoiceID",                    // Unique invoice identifier on the merchant side
  "clientId": "clientID",                      // Unique client identifier on the merchant side
  "type": "benefitpay",                        // Method type
  "clientCard": "payer's bank card/phone",     // Optional: payer's bank card mask or mobile number
  "clientName": "payer's full name",           // Optional: payer's full name
  "successUrl": "https://example.com/success", // Optional (widget): URL for redirect on successful payment
  "failUrl": "https://example.com/fail",       // Optional (widget): URL for redirect on failed payment
  "backUrl": "https://example.com/back",       // Optional (widget): URL for return without completing payment
  "lang": "AR"                                 // Optional (widget): localization (EN/AR)
}

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

{
  "amount": 1000,                               // Payout amount
  "currencyTo": "BHD",                          // Currency
  "invoiceId": "invoiceID",                     // Unique invoice identifier on the merchant side
  "clientId": "clientID",                       // Unique client identifier on the merchant side
  "type": "benefitpay",                         // Method type
  "baseCurrency": "fiat",                       // Base currency type (fiat, crypto)
  "feesStrategy": "add",                        // Fees handling strategy (add, sub)
  "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
  }
}