Initiate Payment (Transaction)

1	import requests
2
3	url = "https://api.crisscross.money/v1/payment"
4
5	payload = {
6	"paymentMethodId": "card",
7	"sessionId": "0d3f1d6c-1c49-4b89-9db6-1fdc06f24c8a",
8	"paymentDetails": {
9	"type": "card",
10	"encryptedCardNumber": "ev-token",
11	"encryptedCardCvv": "ev-cvv-token",
12	"cardExpiryMonth": "12",
13	"cardExpiryYear": "2028",
14	"cardHolderName": "Chinwe Okafor",
15	"payerEmail": "[email protected]"
16	}
17	}
18	headers = {"Content-Type": "application/json"}
19
20	response = requests.post(url, json=payload, headers=headers)
21
22	print(response.json())

{
  "transactionId": "9f3e4b2c-1a6d-4e88-9d3a-ff1234567890",
  "status": "PENDING",
  "message": "Authorization required",
  "authState": {
    "type": "redirect"
  }
}

Initiates a payment transaction for an existing checkout session. PayOS models a “payment” as a transaction; the primary identifier is transactionId.

Request

This endpoint expects an object.

paymentMethodIdenumRequired

Payment method identifier.

sessionIdstringRequired

Unique identifier for the session.

paymentDetailsobjectRequired

signaturestringOptional

Optional signature used for hosted checkout verification.

attributesmap from strings to stringsOptional

Optional transaction attributes.

Response

Transaction initiated successfully.

transactionIdstring

Unique identifier for the transaction.

statusstring

Current transaction status.

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.

Request

Response

Errors