Overview

Customers pay with bank cards, Edfali or MobiCash, whichever your application has enabled.

How a payment flows

1. Your server creates a payment intent (POST /payment-intents) and stores its uuid.
2. You redirect the customer to its checkout_url.
3. The customer pays on Fanak. You never handle cards or one-time codes.
4. Fanak sends your server a signed payment_intent.succeeded webhook.
5. Your server re-fetches the intent (GET /payment-intents/{uuid}) and fulfils only on succeeded.
6. The customer returns to your return_url, where you re-fetch it too.

Trust the intent, not the message

Webhooks and returns are only signals. Act on the re-fetched intent’s status, never on what a webhook or browser sends.

What you need

• An API key (pk_...), an access token and a webhook secret (whsec_...) from the dashboard. See Authentication.
• A server for every API call. Never call from a browser or app.
• An HTTPS webhook endpoint.

https://pay.fanak.ly/api/v1

Not available yet

• List, update or cancel intents through the API.
• Refunds. A succeeded payment is final; settle reversals with your customer.

Next steps

QuickstartCreate your first payment intent and send a customer to pay.

WebhooksReceive payment events and verify their signature.

Payment intentsFields, statuses and expiry.

API referenceEvery endpoint, field and response.