Start a payment

Opens a checkout session and returns the URL to send your customer to.

Send your secret key: Authorization: Bearer sk_live_…. See authentication.

Starts a checkout and returns a URL to send the customer to.

curl https://api.paymonetra.com/v1/payments \
  -H "Authorization: Bearer sk_live_..." \
  -d amount=45000 \
  -d reference=SF-10482 \
  -d description="Ankara bundle"

{
  "reference": "ef8e7ff7078b893d03",
  "merchant_reference": "SF-10482",
  "status": "pending",
  "amount": 45000,
  "amount_requested": 45000,
  "account_number": "5048135286",
  "account_name": "MONETRA TECHNOLOGIES LTD",
  "checkout_url": "https://pay.paymonetra.com/ef8e7ff7078b893d03",
  "collects": ["bank_transfer"]
}

This is the call you want. The payer is given an account borrowed for twenty minutes and locked to exactly this amount, so amount is a round figure and equals amount_requested.

reference is your own order id and makes this idempotent: calling it again with the same one returns the same session rather than quoting a second amount for one order. Sending it is strongly recommended.

The checkout page collects a name and email before it shows an account, because a receipt has to go somewhere. Send customer_name and customer_email and the payer is never asked.

amount_over_limit is refused here rather than at the payer's bank, so you find out instead of your customer watching a transfer bounce.

Payments has the context around this call.