On this page, you can familiarize yourself with the details of primary authorization and completion authorization.
Information about the endpoint and HTTP method used to initiate primary authorization is provided below:
HTTP Metod | URL |
---|---|
POST |
/payment/v1/card-payments |
All parameters of a regular payment request are also applicable to primary authorization. To create primary authorization, the request must be sent with the paymentPhase
parameter set to PRE_AUTH
.
You can create primary authorization by studying the payment acceptance service and sending the expected parameter in the primary authorization request. The response obtained during the creation of primary authorization is similar to the response in a regular payment request.
See the payment acceptance service: Payment Acceptance
Primary authorization using 3D Secure is also applicable to regular 3D Secure flows. When the end user authenticates themselves using the received OTP code, the PRE_AUTH
operation will be completed as 3D Secure.
The PRE_AUTH
3D Secure operation must first be completed using the 3D Complete service and then the authorization completion service can be used.
Information about the endpoint and HTTP method used to initiate primary authorization with 3D Secure is provided below:
HTTP Metod | URL |
---|---|
POST |
/payment/v1/card-payments/3ds-init |
All parameters of a regular 3D Secure payment request are also applicable to primary authorization. To create primary authorization, the request must be sent with the paymentPhase
parameter set to PRE_AUTH
.
You can create primary authorization by studying the payment acceptance service and sending the expected parameter in the primary authorization request. The response obtained during the creation of primary authorization is similar to the response in a regular payment request.
See the payment acceptance service: Payment Acceptance
For a successfully created primary authorization payment, you can complete the authorization to finalize the payment.
Information about the endpoint and HTTP method used to complete primary authorization is provided below:
HTTP Method | URL |
---|---|
POST |
/payment/v1/card-payments/:id/post-auth |
Parameter Name | Type | Required | Description |
---|---|---|---|
id |
number |
Yes | ID of the payment for which primary authorization was performed |
paidPrice |
number |
Yes | Amount required to complete the authorization |
The parameters returned as a result of the payment process adhere to the rules specified in the Return Formats section on the main page of the API documentation. The response obtained during the completion of authorization is similar to the response to a regular payment request. See Payment Retrieval for the payment service.