Developers
An API built to be integrated quickly and well.
Create a payment session, redirect your customer, receive a signed webhook. Test everything with sk_test keys before going live.
- Documentation in English
Payment sessions API
api.sollupay.com/api/v1
- POST/gateway/sessions/
- GET/gateway/sessions/{id}/
- GET/gateway/sessions/list/
- POST/gateway/sessions/{id}/cancel/
- POST/gateway/sessions/{id}/refund/
Guides
A guide for every step.
Each guide starts from a real case, with the API's requests and responses.
- QuickstartYour first test payment, from the session to the webhook.
- Hosted checkoutA session's lifecycle, its statuses and the return to your website.
- WebhooksThe seven events, verifying the signature and retries.
- RefundsFull or partial, safe to retry without refunding twice.
- TestingTest mode, its keys and what to check before going live.
- Going liveThe steps to take real payments.
AI assistants
Integrate Sollupay with your coding assistant.
Skills for Claude Code and for any agent that reads the SKILL.md format: Codex, Cursor, GitHub Copilot, Gemini CLI and more. They read the current documentation while they work.
A sk_test test key is all they need. The skills never ask for your live key.
Install
/plugin marketplace add beyond-payments/sollupay-ai
/plugin install sollupay@sollupay-ainpx skills add beyond-payments/sollupay-ai/sollupay:integrateReads your project, proposes a plan, then builds the hosted checkout, signed webhooks and tests once you approve.
/sollupay:auditReviews an existing integration and lists findings by severity, with the file and the fix.
/sollupay:webhooksAdds or fixes the webhook handler: signature, duplicates, order updates.
/sollupay:refundsAdds full and partial refunds, with an idempotency key.
/sollupay:testChecks your handler's tests, then walks you through test events from your dashboard.
/sollupay:go-liveChecks that everything is ready before live payments.
/sollupay:upgradeBrings your integration up to date with the latest API.
/sollupay:explain-errorExplains an API error or a failing webhook, and finds the code behind it.
Developers
Your first test payment in under 10 minutes.
A clear REST API, complete documentation and an isolated test environment. Create a session, redirect your customer, receive the webhook.
- JSON REST APISimple resources and explicit errors.
- Test modesk_test keys and test cards, no real money.
- Signed webhooksCheck that every notification comes from Sollupay.
- Safe retriesThe same order reference returns the same session.
curl https://api.sollupay.com/api/v1/gateway/sessions/ \ -H "Authorization: Bearer sk_test_…" \ -H "Content-Type: application/json" \ -d '{ "amount": "10.500", "currency": "TND", "merchant_reference": "order-0001", "first_name": "Aymen", "last_name": "Ben Salah", "email": "aymen@example.com", "return_url": "https://your-site.tn/orders/order-0001/paid" }'201 Created
{ "id": "ps_0b7c3a1e…", "status": "CREATED",
"checkout_url": "https://pay.sollupay.com/checkout/kq2V8Zr3…" }Ready to get paid online?
Create your account, try everything in test mode, then switch to live payments once your company is verified.