.svg){kind=logo}
Authorize Payment
POST
https://api.payos.money/api/v1/payment/authorize
Authorize a pending payment transaction with additional authentication data.
Request
This endpoint expects an object.
transactionIdstringRequired
Transaction ID to authorize
authDataFieldslist of objectsRequired
Authorization data fields
sessionIdstringOptional
Session ID for hosted checkout
signaturestringOptional
HMAC signature for hosted checkout
Response
Payment authorized successfully
statusstring
Current transaction status
transactionIdstring
Unique transaction identifier
messagestring
Status message describing the transaction state
authStateobject or null
Authentication state union containing all possible transaction states
merchantReferencestring or null
Merchant reference from the original session
sessionIdstring or null
Session ID associated with the transaction
identifiersmap from strings to strings or null
Additional identifiers related to the transaction
paymentAttributesmap from strings to strings or null
Payment-specific attributes and metadata
processorReferencestring or null
Payment processor reference
financialTransactionReferencestring or null
Financial transaction reference from the processor
currentAttemptIdstring or null
Current attempt identifier