This endpoint requests a payment auth, which determines the order approval status. If approved, the auth will have an expiration date and time, which is returned in the events list for the "AUTH_APPROVED" payment event.

📘

Note

This operation is idempotent based on the requestId (if provided), which allows for the safe retry of multiple requests, guaranteeing the payment operation is only performed once.

📘

Note

The consumer's payment plan will begin at the time of auth approval.

Approved Response (201)

If payment is approved by Clearpay, returns a Payment object in response, with a status of "APPROVED" and a paymentState of "AUTH_APPROVED".

Declined Response (402)

If payment is declined by Clearpay, for example, if invalid card details were entered, returns a Payment object in response, with a status of "DECLINED" and a paymentState of "AUTH_DECLINED".

Please advise the consumer to contact the Clearpay Customer Service team for more information.

Connection Timeouts

Timeout

Time (Seconds)

Open

10

Read

70

Errors

In addition to the PUT/POST Errors applicable to all POST endpoints, the following errors are specific to Auth:

HTTP Status Code

errorCode

Description

402
Payment Required

invalid_token

The checkout token is invalid, expired, or does not exist.

412
Precondition Failed

invalid_order_transaction_status

The Consumer has not confirmed their payment for the order associated with this token.

422
Unprocessable Entity

invalid_object

The checkout token was missing or empty.

Language
Authentication
Basic
base64
:
Response
Click Try It! to start a request and see the response here!