01.software Docs

confirmLegacyPayment

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

All HTTP operations
POST
/api/orders/confirm-payment

sk01_ write only; PAT/customer/session denied. Provider-finality policy still applies; caller evidence is not a generic financial bypass.

Authorization

serverSecretKey
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

Optional retry identity. Preserve exact body and identity for the same operation; absence does not imply safe automatic retry.

Length1 <= length

Request Body

application/json
  1. body
orderNumber?string
Length1 <= length
checkoutToken?string
Length1 <= length
pgPaymentId*string
Length1 <= length
pgProvider*string
Match^[a-z0-9][a-z0-9_-]{0,63}$
pgOrderId?string
Length1 <= length
amount*integer
Range0 <= value <= 9007199254740991
currency?string
Length1 <= length
paymentMethod?string
receiptUrl?string
Formaturi
approvedAt?string
providerStatus?string
providerEventId?string
Length1 <= length
confirmationSource?string
Value in"provider_webhook""provider_lookup""provider_api_confirm""manual_server"
paymentKey?string
Length1 <= length
metadata?

Response Body

Actual shaped success body

application/json
  1. response
orderId*string
Length1 <= length
transactionId*string
Length1 <= length
status*"paid"
Value in"paid"
alreadyConfirmed?boolean

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/confirm-payment' \  -H 'Content-Type: application/json' \  -d '{  "pgPaymentId": "string",  "pgProvider": "string",  "amount": 0}'
Example Response
{  "orderId": "string",  "transactionId": "string",  "status": "paid",  "alreadyConfirmed": true}