> ## Documentation Index
> Fetch the complete documentation index at: https://developer.kalixo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment methods

> How Kalixo chooses payment methods and how each kind of method behaves.

You integrate once, with [Kalixo.js](https://developer.kalixo.io/checkout/guides/kalixo-js.md) or the
[hosted checkout](https://developer.kalixo.io/checkout/guides/hosted-checkout.md), and Kalixo shows the shopper the
payment methods that fit the checkout session. You never add a method-specific SDK, and new
methods need no change on your side.

Kalixo chooses the methods from the session's `country` and `currency` and from what is
enabled for your account. A method that does not fit the session is not shown.

> [!NOTE]
>
> Kalixo configures which payment methods your account offers. Ask
> [integrations@kalixo.io](mailto:integrations@kalixo.io) which methods are available for your
> markets, or to enable one.

## How methods behave

| Kind | What the shopper does | When you know the outcome |
| - | - | - |
| Cards and wallets | Pays in the secure fields or the wallet sheet, with a [3D Secure](https://developer.kalixo.io/checkout/concepts/3d-secure.md) step when the issuer requires it | Usually within seconds |
| Redirect methods | Leaves for their bank or wallet, approves, and comes back to your `return_url` with `?session_id=cs_...` | Usually when they return, sometimes later by webhook |
| Asynchronous methods, such as bank debits | Confirms the payment; the money arrives later | Minutes to days later, by webhook only |

For every kind, wait for `payment.captured` and read the payment on your server before you
deliver. The shopper may close the tab before returning from a redirect. See
[Fulfilment](https://developer.kalixo.io/checkout/guides/fulfilment.md).

## Create sessions that fit

* Set `country` to the shopper's country and `currency` to the currency you sell in. Local
  methods appear only for their home market and currency.
* The shopper always pays the session `amount`. If a provider reports a different amount,
  Kalixo sets `amount_mismatch: true` and reverses the payment. See
  [Amount integrity](https://developer.kalixo.io/checkout/concepts/amount-integrity.md).
* The payment's `payment_method.type` tells you which method the shopper used.

## Capture and refunds

Many redirect and bank methods capture at authorisation: they do not support manual or
partial capture. Use `capture_method: "manual"` only when the methods on your account
support it, typically cards. See
[Captures, cancellations and refunds](https://developer.kalixo.io/checkout/guides/captures-and-refunds.md).

## Testing

The sandbox test cards are on the [Testing](https://developer.kalixo.io/checkout/concepts/testing.md) page. If Kalixo
routes your sandbox account to a payment provider's test environment, the checkout shows that
provider's test form, and Kalixo integrations sends you the test data for each method.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.