BenefitPay

Start accepting payments using BenefitPay, Bahrain's electronic wallet payment system.

📘

To start accepting BenefitPay payments, please contact your customer success manager.

Process a BenefitPay payment

You can process a BenefitPay payment in two steps:

1. Request a BenefitPay payment
2. Display the QR code to the customer

Step 1: Request a BenefitPay payment

The request

Use the details below to set up your request.

Endpoints

Live

POSThttps://api.checkout.com/payments

Sandbox

POSThttps://api.sandbox.checkout.com/payments

Header parameters

Body parameters

📘

The table below describes the minimum recommended fields. You can find the full list, as well as complete request and response examples, in our API reference.

Request example

{
  "amount": 1000,
  "currency": "BHD",
  "source": {
    "type": "benefitpay",
    "integration_type": "web"
  }
}

The response

If you receive a 202 response with "status": "Pending", BenefitPay has accepted your transaction request. We will also send you payment_pending and payment_capture_pending webhooks to confirm.

Response example

{
  "id": "pay_aeb7fegfsihejgpeeby36rrf3y",
  "status": "Pending",
  "customer": {
    "id": "cus_uj7uhbi2lwaela6fsx6apeztv4"
  },
  "_links": {
    "self": {
      "href": "https://api.sandbox.checkout.com/payments/pay_aeb7fegfsihejgpeeby36rrf3y"
    }
  }
}

Step 2: Display the QR code

To capture the pending payment, you will need to display the associated QR code to your customer for them to scan with the BenefitPay mobile app.

To do this you will need to get the QR code data, convert that into a QR code and then display it on your payment page.

Get QR code data

The request

Use the details below to get the source.qr_data.

Endpoints

Live

GEThttps://api.checkout.com/payments/{payment_id}

Sandbox

GEThttps://api.sandbox.checkout.com/payments/{payment_id}

Header and path parameters

The response

Response example

{
  "id": "pay_aeb7fegfsihejgpeeby36rrf3y",
  "requested_on": "2019-10-16T06:54:09Z",
  "source": {
    "type": "benefitpay",
    "reference_number": "aaf902e2-23de-4980-a305-d3c43a013255",
    "qr_data": "00020101021205081000019949440008mobi.foo010810000199021010000000010402db52046300530304854051.0005802BH5907Talabat6003Web62570536aaf902e2-23de-4980-a305-d3c43a0132550713201754708940863048B0C"
  },
  "amount": 1000,
  "currency": "BHD",
  "payment_type": "Regular",
  "status": "Pending",
  "risk": {
    "flagged": false
  },
  "customer": {
    "id": "cus_uj7uhbi2lwaela6fsx6apeztv4"
  },
  "_links": {
    "self": {
      "href": "https://api.sandbox.checkout.com/payments/pay_aeb7fegfsihejgpeeby36rrf3y"
    }
  }
}

Create and display the QR code

Now take the source.qr_data obtained in the previous step and turn it into a QR code (via an API or your own implementation). You should then display this on your payment page so the customer can scan it with their BenefitPay mobile app and complete the transaction.

👍

Once the customer has completed the payment by scanning the QR code, we will send you a payment_captured webhook notification to confirm the success of the payment.

BenefitPay refunds and chargebacks

BenefitPay has no native support for refunds. If you want to refund a customer who has made a BenefitPay payment, we recommend that you make the refund using a standard bank transfer.

In addition, there is no chargeback mechanism for BenefitPay.

BenefitPay webhooks

When using BenefitPay, you may receive the following webhooks.

📘

Learn more about webhooks and how to subscribe to them.

Testing BenefitPay

🚧

To start testing, you'll need to:

• create a test account, and
• contact your customer success manager or integrations engineer to activate BenefitPay payments in the sandbox environment.

1. Create a BenefitPay payment request and get the QR code data, as described above.
2. Convert the QR code data into a QR code.
3. Download BenefitPay's simulator app.
4. Scan the QR code with the app to capture and complete the test payment.

📘

Downloading BenefitPay's mobile app

To download BenefitPay's simulator app, simply provide BenefitPay with an account ID (either a Google Play Store ID or an Apple ID) and then, once you've installed it, supply a mobile number to complete your registration.

Can we help?

Thanks for using Checkout.com. If you need help or have a question, message our support team at [email protected].