v2

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-04-1516093.4 KB
Payments

Create Payment Session

Create a payment session (merchant-facing). Called by plugins (WooCommerce, Medusa, etc.) to start a BKey-approved payment flow. The merchant authenticates with a mk_live_* / mk_test_* API key. Returns an approvalUrl to redirect the shopper to.

post/v1/payment-sessions/

Request body

merchantDomainstring
externalOrderIdstring
amountinteger required
currencystring
returnUrlstring uri required
notifyUrlstring uri
cancelUrlstring uri
customerEmailstring email
expiresInSecsinteger

Response

Default Response

successboolean required