Benefit Payment Gateway (PG) Beta

Start accepting payments using Benefit Payment Gateway (PG), a fast and secure payment method in Bahrain.

Benefit Payment Gateway (PG) is a solution that enables merchants to process transactions through debit cards. Payments can be processed via websites or mobile applications.

Using Benefit PG requires the merchant to register via one of the Benefit’s supported acquirers first.

Use the details below to set up your request. To get a detailed view of all required and optional fields, see our API reference.

{
    "source": {
        "type": "benefit"
    },
    "reference": 772,
    "currency": "BHD",
    "amount": 1000,
    "processing_channel_id": "pc_ekaubqrravqupfxde7kxvd2t3i",
    "success_url": "https://example.com/200",
    "failure_url": "https://example.com/422"
}

If you receive a 202 response with status Pending, Benefit PG has accepted your transaction request.

{
    "id": "pay_qexughhq5l2unjpevzxovl5ksu",
    "status": "Pending",
    "reference": "368",
    "_links": {
        "self": {
            "href": "https://gwc.ckotech.co/gateway/payments/pay_qexughhq5l2unjpevzxovl5ksu"
        },
        "redirect": {
            "href": "https://www.test.benefit-gateway.bh/payment/paymentpage.htm?PaymentID=145202215328911475"
        }
    }
}

To learn about payment status, you can set up webhooks to receive notifications.

You may receive the following webhooks when using Benefit PG:

You can use the id found in the payment response to retrieve details about an existing Benefit PG payment.

{
  "id": "pay_qexughhq5l2unjpevzxovl5ksu",
  "requested_on": "2022-06-02T08:17:02.0430752Z",
  "source": {
    "type": "benefit"
  },
  "amount": 1000,
  "currency": "BHD",
  "payment_type": "Regular",
  "reference": "368",
  "status": "Pending",
  "_links": {
    "redirect": {
      "href": "https://www.test.benefit-gateway.bh/payment/paymentpage.htm?PaymentID=145202215328911475"
    },
    "self": {
      "href": "https://gwc.ckotech.co/gateway/payments/pay_qexughhq5l2unjpevzxovl5ksu"
    },
    "actions": {
      "href": "https://gwc.ckotech.co/gateway/payments/pay_qexughhq5l2unjpevzxovl5ksu/actions"
    }
  }
}

Benefit PG supports full, partial and multiple partial refunds. Note that you need to request partial refund enablement from Benefit when you sign up with them.

You can process a refund through the Dashboard or using the Refund API.

Disputes and chargebacks can be raised through the buyer's bank or through your acquiring company.

{
  "action_id": "act_mg6cqtudpuzund46uee3yrkvrm",
  "_links": {
    "payment": {
      "href": "https://gwc.ckotech.co/gateway/payments/pay_soaizebivsxubh2pvdpsiaop6q"
    }
  }
}

To start testing, you'll need to: