Developer guide

Choose your checkout experience

Hosted method selector, selected-method checkout, or direct integration.

Choose where your buyer selects and completes the payment. All three experiences use the same methods, order identifiers and payment status contract.

Our checkout · method selector

The buyer chooses an available method in our checkout.

Your site → Our selector → PaymentView integration

Our checkout · selected method

Select the method in your app. Open its checkout directly.

Your method → Our checkout → PaymentView integration

Direct integration

Render returned payment data in your checkout, or open the bank link for cards.

Your checkout → Our API → Payment dataView integration

These guides use the existing API. Direct integration keeps Key2Pay-Version: 2026-05-01 (also the default when omitted): HTTP 200, transactionId and payment instructions or paymentFormUrl. Opting into 2026-10-12 returns HTTP 201 awaiting_consent and checkoutUrl first. Hosted checkouts always collect buyer acceptance. Keep your current version and handle its response; a retry keeps the original contract.