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

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

Name of the payment processor (if assigned).

processorReferencestring

Processor reference (if available).

paymentAttributesmap from strings to strings

Attributes associated with the payment.

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

1	curl -X POST https://api.crisscross.money/v1/payment/authorize \
2	-H "Content-Type: application/json" \
3	-d '{
4	"body": {
5	"transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
6	}
7	}'

1	{
2	"status": "authorized",
3	"transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4	"message": "Payment authorized successfully.",
5	"authState": {
6	"type": "challenge_required"
7	},
8	"processorName": "Stripe",
9	"processorReference": "ch_1J2Y3Z4a5b6c7d8e9f0g",
10	"paymentAttributes": {}
11	}