Initiate Payment

Processes a payment transaction directly.

This endpoint expects an object.

sessionIdstringRequired

Session ID from checkout session creation

paymentMethodIdenumRequired

Payment method identifier

paymentDetailsobjectRequired

Payment method specific details

attributesmap from strings to stringsOptional

Additional transaction attributes as key-value pairs

signaturestringOptional

HMAC signature for hosted checkout validation

Payment processed with result

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

1	curl -X POST https://api.payos.money/api/v1/payment \
2	-H "Content-Type: application/json" \
3	-d '{
4	"sessionId": "sessionId",
5	"paymentMethodId": "card",
6	"paymentDetails": {
7	"type": "capitecpay"
8	}
9	}'

1	{
2	"status": "status",
3	"transactionId": "transactionId",
4	"message": "message",
5	"authState": {
6	"state": "state",
7	"transitionedAt": "transitionedAt",
8	"transactionId": "transactionId"
9	},
10	"merchantReference": "merchantReference",
11	"sessionId": "sessionId",
12	"identifiers": {
13	"key": "value"
14	},
15	"paymentAttributes": {
16	"key": "value"
17	},
18	"processorReference": "processorReference",
19	"financialTransactionReference": "financialTransactionReference",
20	"currentAttemptId": "currentAttemptId"
21	}