Authorize a Payment (Transaction)

Submits additional authorization data for a transaction when required (e.g. after a redirect or challenge). The exact fields depend on the authState returned by initiation/polling.

Request

This endpoint expects an object.
transactionIdstringRequiredformat: "uuid"
Unique identifier for the transaction.
authorizationDatamap from strings to anyOptional

Authorization payload (varies based on authState).

Response

Authorization submitted successfully.
statusstring
Current transaction status.
transactionIdstring
Unique identifier for the transaction.
messagestring

Human-readable status message.

authStateobject or null

Indicates additional steps required to complete a transaction. The shape varies by payment method and processor. Use type to determine which fields are present.

processorNamestring or null

Name of the payment processor (if assigned).

processorReferencestring or null

Processor reference (if available).

paymentAttributesmap from strings to strings or null
Attributes associated with the payment.

Errors