Skip to content
Sollupay

Online payments

Accept card payments on your website.

Your website creates a session with the API. Your customer pays on a hosted page, in French or English, with 3-D Secure. The result reaches your server as a signed webhook.

  • Visa and Mastercard
  • 3-D Secure on every payment
  • Page in French and English
pay.sollupay.com
The Sollupay payment page: the Jawhara Online Store shop, order JW-2031, an amount of 184.500 TND and the Pay button.
The real payment page, with a demo shop.

How it works

From cart to paid order, in four steps.

  1. 1

    Create a session

    Your server sends the amount, the customer and your order reference. The API answers with the payment page's address.

  2. 2

    Redirect your customer

    They land on pay.sollupay.com, with your shop's name, their order and the amount.

  3. 3

    They pay, protected by 3-D Secure

    They type their card on the secure page of Société Monétique Tunisie, then their bank confirms the payment.

  4. 4

    You confirm the order

    Sollupay sends the signed result to your server. You confirm the order and your customer comes back to your website.

The payment page

A payment page you don't have to build.

Your customer sees your name, their order and the amount, picks their language and pays by card. You have nothing to host.

  • No card data on your sideThe card is typed on the secure page of Société Monétique Tunisie. It never goes through your website or your servers.
  • 3-D Secure on every paymentThe customer's bank checks the card is really theirs: a code by SMS, an approval in their banking app, or nothing at all.
  • A decline doesn't lose the saleAfter a decline, your customer tries again on the same page, with the same card or another. Five tries by default, 1 to 10 as you choose.
  • In your mobile app tooOpen the page in an in-app browser tab. 3-D Secure works there just as it does on the web.

Payment attempts

Order JW-2031

  1. Try 1DeclinedInsufficient funds
  2. Try 2ApprovedVisa •••• 1119 · 3-D Secure

3 tries were still available

For developers

An API built so you never charge twice.

Simple calls, an isolated test environment and safeguards against duplicates, both ways.

  • One reference, one sessionSending the same merchant_reference again returns the same session: a retried request never creates a second payment.
  • Full test modesk_test keys and test cards, no real money. Live keys come once your business is verified and are shown only once.
  • Your data comes alongAdd your own fields to the session. They come back unchanged in every webhook.
  • Retrieve, list, cancelRead a session and its attempts, list your payments, cancel a session that hasn't been paid.

Webhook received by your server

POST/webhooks/sollupay

X-Webhook-Signature: t=1795689840,v1=5257a869e7ecebeda32a…

{  "id": "evt_5f1c2a9d8e7b6a5f4e3d2c1b",  "event": "session.succeeded",  "livemode": true,  "data": {    "merchant_reference": "JW-2031",    "amount": "184.500",    "currency": "TND",    "status": "SUCCEEDED",    "payment": {      "card_brand": "VISA",      "card_last_four": "1119"    },    "metadata": { "cart_id": "8812" }  }}

Webhooks

Every payment's outcome, signed and delivered.

Confirm orders on the webhook, not on the browser's return: your customer may close the tab before being redirected.

  • HMAC signatureEvery request is signed with your secret. You check it really comes from Sollupay and that it's recent.
  • Secret rotationChange your secret whenever you like: the old one stays valid for 24 hours while you update your server.
  • 10 more triesIf your server doesn't answer, Sollupay tries again 10 times over about 3 days.
  • Logs and resendFind every delivery in your dashboard and resend an event in one click.

Seven events

Refunds

Refund a customer from the API or the dashboard.

A full refund is accepted right away. A partial refund is accepted once the payment has settled, usually the next day.

  • Full or partial, in several goes up to the amount paid
  • An Idempotency-Key to retry without refunding twice
  • The refund.succeeded and refund.failed webhooks follow every refund

Refund · order JW-2031

Paid
184.500 TND
Already refunded
0.000 TND
FullPartial

Amount to refund

30.000 TND

Reason

Damaged item

Refund

Integrations

Plugged into the tools you already use.

Plugins for the main e-commerce and hosting platforms are coming soon. In the meantime, connect your website with the API.

Ready to get paid online?

Create your account, try everything in test mode, then switch to live payments once your company is verified.