Payments

Cards (Mastercard)

Card payments run through the Mastercard Payment Gateway Services (MPGS) connector.


Initiate

{
  "amount": 10.000,
  "currency": "BHD",
  "payment_provider": "mastercard"
}

Response includes track_id and payment_url pointing at the Mastercard hosted payment path on the Payment Engine.


Customer experience

  • Customer opens the hosted payment page
  • Enters card details / completes 3-D Secure as required by the acquirer
  • Engine receives the gateway callback and finalizes status
  • Optional webhook notifies your server

Subscriptions

Recurring billing currently uses Mastercard only. See Subscriptions.


Refunds

Mastercard (and Apple Pay via MPGS) support refunds through POST /merchant/refund-payment. See Refunds.

Sandbox card numbers and response controls: Sandbox test cards.