Brainerce
Help CenterPricingResourcesDashboard
API ReferenceEndpointsCheckoutConfirm SDK-based payment (Storefront, sdk-confirm)

Confirm SDK-based payment (Storefront, sdk-confirm)

Tells the server that a client-side payment SDK finished successfully, with the callback data the SDK returned. The server checks the callback data with the provider; an empty body is treated as no data and never confirms a payment. Also served at the legacy path payment/grow-confirm.

POST
/vc/{connectionId}/payment/sdk-confirm

Authorization

X-Sales-Channel-Origin<token>

For /api/vc/{connectionId}/* routes the connectionId (vc_*) is in the URL path — not a header. Live-mode requests must also send a matching Origin header.

In: header

Path Parameters

connectionIdstring

Sales channel ID (vc_*), the canonical salesChannelId. connectionId is the deprecated name of the same value and is still the literal path segment.

Header Parameters

originstring

Origin of the storefront page making the call, for example https://shop.example.com. Required: a request with no Origin header is refused with 403. On a LIVE channel its host must equal the channel's registered domain (or one of its subdomains) or match an allowed origin. A TEST channel with no domain accepts any origin; once a domain is set it is matched as on LIVE.

X-SDK-Version?string

Version of the calling SDK (the Brainerce SDK sends it automatically). Informational: it is recorded on the channel and never changes the response.

Request Body

checkoutIdstring

Checkout to finalise.

providerResponseData?object

Raw response payload from the payment SDK. Provider-specific shape.

confirmationNumber?stringDeprecated

Legacy field, for the older provider-specific SDKs only. Prefer providerResponseData.

growResponseData?objectDeprecated

Legacy field, for the older provider-specific SDKs only. Prefer providerResponseData.

curl -X POST "https://api.brainerce.com/api/vc/string/payment/sdk-confirm" \  -H "origin: string" \  -H "X-SDK-Version: string" \  -H "Content-Type: application/json" \  -d '{    "checkoutId": "chk_abc123"  }'
{
  "confirmed": true
}

{
  "statusCode": 400,
  "code": "VALIDATION_FAILED",
  "message": "name should not be empty, price must be a positive number",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/vc/{connectionId}/payment/sdk-confirm"
}

{
  "statusCode": 403,
  "code": "INSUFFICIENT_SCOPE",
  "message": "API key does not have the required scope: products:write",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/vc/{connectionId}/payment/sdk-confirm"
}

{
  "statusCode": 404,
  "code": "RESOURCE_NOT_FOUND",
  "message": "Resource not found",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/vc/{connectionId}/payment/sdk-confirm"
}

{
  "statusCode": 429,
  "code": "RATE_LIMITED",
  "message": "Too many requests",
  "details": {
    "retryAfterSeconds": 12
  },
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/vc/{connectionId}/payment/sdk-confirm"
}

Create payment intent

Creates a payment intent with the store payment provider for a checkout and returns what the storefront needs to confirm it client-side (intent id, clie...

Confirm SDK-based payment (Storefront, grow-confirm)

Tells the server that a client-side payment SDK finished successfully, with the callback data the SDK returned.