Skip to content
Guarantee Pay Docs

Guarantee Pay docs

Accept payments with local & global gateways

Create a checkout from your server, send the customer to the hosted payment page, and confirm the result with a webhook or a verify call. Pair the Android companion app to auto-match MFS SMS payments.

Create a charge POST /api/create-charge, then redirect to pp_url Verify a payment POST /api/verify-payment with the pp_id Handle webhooks Fulfil only when status is completed Copy a working example PHP, Node.js and cURL, end to end

Base URL

https://payment.yamin.bd

Quick start

  1. Create a brand in the admin panel, then open Brand Settings → API Settings.
  2. Create an API key and tick the permissions you need: Create Payment, Verify Payment and, if you refund, Refund Payment.
  3. Add the domain of your return and webhook URLs under Domains.
  4. Send the header MHS-GUARANTEEPAY-API-KEY on every API request, with a JSON body.
  5. Call /api/create-charge, save the pp_id with your order, and redirect the customer to pp_url.
  6. When the webhook arrives or the customer returns, call /api/verify-payment and fulfil only if status is completed.

Typical flow

1. Your server   → POST /api/create-charge        ← { status, pp_id, pp_url }
2. Customer      → pp_url (hosted checkout)
3. Payment done  → status becomes "completed"
4. Guarantee Pay → POST webhook_url (JSON)
5. Customer      → return_url?pp_status=…&pp_id=…
6. Your server   → POST /api/verify-payment { pp_id } → fulfil the order
Never trust the browser. The return URL and its query string can be opened or edited by anyone. Always confirm with verify-payment on your server before giving value.