kepa
Checkout/recordCnpWalletPaymentAttempt

Record wallet payment attempt

Durably log a wallet (Apple Pay / Google Pay) attempt before confirmation.

POST/api/v1/cnp/public/checkout-sessions/{id}/wallet-payment-attempts
Browser-safeCall from the customer’s browser with a publishable key — never your secret key.
When the customer authorizes a wallet payment, the opaque wallet token and attempt metadata are recorded against the session before confirmation runs, so an attempt is never lost between the wallet sheet closing and the charge being placed.
Path parameters
idstringRequired

Checkout session identifier.

Response

application/json

idstring
checkoutSessionIdstring
paymentIntentIdstring
merchantIdstring
walletTypeenum
APPLE_PAYGOOGLE_PAY
statusenum
RECEIVEDUNSUPPORTEDFAILEDAUTHORIZED
tokenMetadataobject
failureReasonstring
cnpGatewayRouteIdstring

CNP credential route selected before wallet authorization.

cnpGatewayRouteKindenum
SERVER_SIDE_GATEWAYHOST_TO_HOST_ACQUIRERNETWORK_DIRECTINTERNAL_VAULT
cnpGatewayRouteTargetstring
cnpGatewayRouteProviderBoundboolean
cnpGatewayRouteSupportsKepaTokenStorageboolean
createdAtstring · ISO 8601
Example "2026-04-09T09:14:22Z"
Good to know
  • Returns 202 Accepted — it records the attempt; wallet-confirm places the actual charge.
  • Current builds persist a hash of the wallet token payload; live wallet authorization depends on the merchant's wallet adapters being configured.

recordCnpWalletPaymentAttempt

POSTGo API
https://api.kepapay.co/api/v1/cnp/public/checkout-sessions/{id}/wallet-payment-attempts
Request
curl https://api.kepapay.co/api/v1/cnp/public/checkout-sessions/{id}/wallet-payment-attempts \
  -H "X-Kepa-Publishable-Key: $KEPA_PUBLISHABLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "clientSecret": "cs_7c1b9b86_secret_example",
  "walletType": "APPLE_PAY",
  "token": {},
  "metadata": {}
}'
Response
{
  "id": "0195d46e-7088-7cc4-a9b2-5f9273cd63b8",
  "checkoutSessionId": "0195d46e-7088-7cc4-a9b2-5f9273cd63b8",
  "paymentIntentId": "0195d46e-7088-7cc4-a9b2-5f9273cd63b8",
  "merchantId": "string",
  "walletType": "APPLE_PAY",
  "status": "RECEIVED",
  "tokenMetadata": {},
  "failureReason": "string",
  "cnpGatewayRouteId": "string",
  "cnpGatewayRouteKind": "SERVER_SIDE_GATEWAY",
  "cnpGatewayRouteTarget": "string",
  "cnpGatewayRouteProviderBound": true,
  "cnpGatewayRouteSupportsKepaTokenStorage": true,
  "createdAt": "2026-04-09T09:14:22Z"
}