Start - Dokumentacja Techniczna

With the Paymove payment gateway, accepting online payments is simple. As a merchant you initiate the transaction via our API or SDK, and your customer pays on a secure, ready-made payment page. As soon as the payment is completed, your system receives an automatic notification.

You can try a ready-made integration in the Paymove demo shop.

How does a payment work?

Step	Who	What happens
1	Your server	Calls the Paymove API with amount, `externalId` and `returnUrl`
2	Paymove	Returns `redirectUrl` - the checkout page address
3	Customer	Is redirected to checkout and enters payment details
4	Paymove	Sends a signed webhook to the registered URL - by default only for the `COMPLETED` status
5	Your server	Verifies the signature, responds with `{ "status": "ok" }` and fulfills the order
6	Customer	Sees the confirmation screen and may click “back to shop”, which takes them to `returnUrl`

Fulfil the order only after a verified webhook (step 5), never after the customer returns to returnUrl (step 6). Step 6 requires a click and may never happen, and returnUrl itself can be opened without paying for the order.

What you need to integrate

Data	Format	Description
`apiKey`	`sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`	Authorization key passed in the `X-API-KEY` header. Sandbox: `sk_test_`, production: `sk_live_`
`productId`	`2f6c19e8-84a7-4f50-b950-8d5a05e0bbf2`	UUID identifying your store in the Paymove system

You can generate your API key and productId in the Paymove Panel.