Checkout/createCnpPaymentIntent

Create Payment Intent

Create the server-side object representing an online payment.

POST/v1/cnp/payment-intents

Create a CNP payment intent for Hosted Payment Page, Elements, or Drop-in checkout. Your server creates this object; the browser receives only the client secret required to continue the checkout.

Request body

application/json

merchantIdstringRequired

Merchant identifier.

Example "mch_123"

customerIdstring

Optional customer identifier for saved payment methods.

amountMinorintegerRequired

Amount in minor units.

Example 2500

currencyCodestringRequired

ISO 4217 currency code.

Example "USD"

setupFutureUsageenum

Whether to save for future use.

OFF_SESSIONON_SESSION

descriptionstring

Checkout/order description.

Example "Order #10042"

metadataobject

Merchant metadata.

Response

application/json

idstring

Payment intent ID.

statusenum

Intent lifecycle state.

REQUIRES_PAYMENT_METHODPROCESSINGSUCCEEDEDDECLINED

clientSecretstring

Pass to browser checkout; never log or expose outside this checkout.

amountMinorinteger

Amount in minor units.

currencyCodestring

Currency.

createCnpPaymentIntent

curl https://api.kepapay.co/v1/cnp/payment-intents \ -H "X-Api-Key: $KEPA_SECRET_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{"merchantId": "mch_123","amountMinor": 2500,"currencyCode": "USD","description": "Order #10042"}'

{ "id": "00000000-0000-0000-0000-000000000001", "merchantId": "mch_123", "amountMinor": 2500, "currencyCode": "USD", "status": "REQUIRES_PAYMENT_METHOD", "clientSecret": "pi_..._secret_..." }