CollectPaymentsPayment Initiation

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.

authStateobjectOptional

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

sessionIdstringOptionalformat: "uuid"
Session the transaction belongs to.
merchantReferencestringOptional
Merchant reference from the original session.
processorNamestringOptional

Name of the payment processor (if assigned).

processorReferencestringOptional

Processor reference (if available).

paymentAttributesmap from strings to stringsOptional
Attributes associated with the payment.
batchPayoutIdstringOptional
Batch payout identifier, present when the transaction is part of a batch payout.
collectionobjectOptional

Amount the customer paid in the collection currency. Present only on transactions converted by Adaptive Currency Conversion — per-session rate or rate lock.

fxMidRatestringOptional

Spot mid-market rate at the time the FX quote was committed for this attempt (decimal string, 8 decimal places). Present only on FX-converted transactions.

fxAllInRatestringOptional

Mid rate + markup — the rate this attempt was actually converted at (decimal string, 8 decimal places). Present only on FX-converted transactions.

fxMarkupBpsintegerOptional>=0

Markup applied to this attempt in basis points (100 bps = 1%). Present only on FX-converted transactions.

fxFeeobjectOptional

Conversion fee, denominated in the collection currency. Present only on FX-converted transactions.

Errors

400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error