Create payment

Creates a payment by card, saved card, wallet token or recurrent profile.

The X-Action header must be gateway.payment.create.

Sign the request with X-JWS-Signature: see Async API Overview.

The payment is processed asynchronously: the response returns it with status process.

Payment flow by auto_clearing

3DS challenge flow

With a frictionless 3DS flow (3ds.flow_type = F) there is no waiting_3ds step.
The two-step flow after approved is shown in Capture payment (clearing).

Result

Response	Meaning	Next step
`status = process`	The payment is accepted and is being processed.	Get the final status with `gateway.payment.status`. If the response is lost, use `gateway.request.status`.
`status = error`	The payment is declined.	See «Errors» below.
`{}`, `X-Request-Status: process`	The result is not ready yet.	Repeat the request in a few seconds with the same `X-Request-Id`.

Errors

A declined payment is returned with HTTP 200, status error and the error object.
The error is returned in error.code and error.description.

HTTP	`error.code`	When	What to do
`200`	Decline code, for example `10045`	The payment is declined.	Do not repeat the request with the same `X-Request-Id`: it returns the same result.
`400`	`9400`	The body is not valid JSON.	Fix the request.
`401`	`9998`	The signature is invalid.	Check the signature: see Async API Overview.
`422`	`9403`	A required header or field is missing or invalid, for example `X-Request-Id` is not a UUID. The reason is in `error.description`.	Fix the request.
`500`	`9999`	Internal error at the gateway entry point.	Repeat the request later with the same `X-Request-Id`.
`500`	`10000`	Internal error in payment processing.	Repeat the request later with the same `X-Request-Id`.

application/json

Headers

Bodyapplication/json

Examples

Payment createdPayment declinedResult not ready (X-Request-Status: process)

{
  "id": "01978c37-a961-7d20-8434-632242b24d48",
  "status": "process",
  "amount": 100.5,
  "created_at": "2026-06-20T07:13:31.068188524Z"
}

Payment flow by auto_clearing#

3DS challenge flow#

Result#

Errors#

Request

Responses

Payment flow by auto_clearing

3DS challenge flow

Result

Errors