Create Checkout Session

1	curl -X POST https://api.crisscross.money/v1/checkout/session \
2	-H "Content-Type: application/json" \
3	-d '{
4	"merchantId": "1b2a3d4c-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
5	"merchantReference": "ORDER12345",
6	"amount": 15000,
7	"currency": "NGN",
8	"integrationType": "hosted",
9	"payerDetails": {
10	"emailAddress": "[email protected]",
11	"location": "NGA",
12	"fullName": "Chinwe Okafor",
13	"phoneNumber": "08012345678"
14	},
15	"redirectUrl": "https://merchant.com/redirect",
16	"paymentAttributes": {
17	"orderId": "ORDER12345"
18	}
19	}'

{
  "sessionId": "0d3f1d6c-1c49-4b89-9db6-1fdc06f24c8a",
  "paymentLink": "https://crisscross.money/checkout/0d3f1d6c-1c49-4b89-9db6-1fdc06f24c8a",
  "payerId": "2a1c4f1a-0d44-4f16-8c8e-9a3b4c5d6e7f",
  "signature": "hmac-signature"
}

Creates a checkout session. For hosted integrations this may generate a hosted checkout payment link. For direct integrations, the payment link may be omitted.

Request

This endpoint expects an object.

merchantIdstringRequiredformat: "uuid"

The merchant identifier.

merchantReferencestringRequired

Your reference for the checkout session.

amountintegerRequired1-1000000000000

Amount in minor units.

currencyenumRequired

Currency code.

integrationTypeenumRequired

Type of integration.

Allowed values:

payerDetailsobjectRequired

redirectUrlstringOptionalformat: "uri"

Optional URL to redirect after payment.

paymentAttributesmap from strings to stringsOptional

Optional session attributes to pass through the payment lifecycle.

Response

Session created successfully.

sessionIdstring

Unique identifier for the session.

paymentLinkstring or nullformat: "uri"

Hosted checkout payment link (present for hosted integrations).

payerIdstring or nullformat: "uuid"

Identifier for the created/associated payer.

signaturestring or null

Signature used for hosted checkout verification.

Request

Response

Errors