01.software Docs

Create a custom-provider PaymentSession as a server

Use the SDK for application integration. This read-only reference covers Commerce, Customer Auth, Membership and Events.

All HTTP operations
POST
/api/orders/custom-payment-sessions

Creates the bounded server-only bridge for a caller-managed payment provider. This is not integration-managed execution and does not expose provider credentials.

Authorization

publishableKeyserverSecretKey
headerX-Publishable-Key<token>

Tenant publishable key for authentication (sent via X-Publishable-Key header)

headerAuthorizationBearer <token>

Public integration credential: opaque sk01_ secret API key only; PAT and Customer JWT are not supported by this scheme. Requires tenant binding and the read or write scope named by the operation.

Header Parameters

X-Idempotency-Key*string

Caller-generated retry identity. Reuse the same key only when retrying the same logical operation.

Match^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|ik_[A-Za-z0-9_-]{22})$
Lengthlength <= 255

Request Body

application/json
  1. body
provider*string
Match^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$
Length1 <= length <= 64
checkoutToken*string
Length1 <= length <= 512

Response Body

Create a custom-provider PaymentSession as a server result

application/json
  1. response
id*string
Length1 <= length <= 255
provider*string
Match^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$
Length1 <= length <= 64
providerSessionId*string
Match\S
Length1 <= length
money*

Examples may be generated from schemas; they are illustrative, not recorded successful API calls. Example snippets may omit required authentication headers.

Example Request
curl -X POST 'https://api.01.software/api/orders/custom-payment-sessions' \  -H 'X-Idempotency-Key: string' \  -H 'Content-Type: application/json' \  -d '{  "provider": "string",  "checkoutToken": "string"}'
Example Response
{  "id": "string",  "provider": "string",  "providerSessionId": "string",  "money": {    "amountMinor": 0,    "currency": "string"  }}