---
title: Pay with PalmPay
description: Let customers pay from their PalmPay account on any ZevPay checkout. Approval happens on PalmPay's page; confirmation and settlement work like every other method.
---

# Pay with PalmPay

Customers pay directly from their PalmPay wallet. When they pick PalmPay, they approve the payment on PalmPay's own page (or app), then return to your checkout, which confirms automatically.

::: info Rolling out gradually
Pay with PalmPay is being enabled account by account. If you do not see it on your checkouts yet, contact support to request access.
:::

## How it works per surface

- **Standard (hosted) checkout**: the customer is redirected to PalmPay to approve, then returned to the checkout page, which shows the confirmed payment.
- **Inline**: the approval opens in a new tab so your page never navigates away. The modal waits and confirms automatically the moment the payment lands.
- **Invoice**: same as inline; the invoice page confirms in place and becomes the receipt.

No integration changes are needed. The method rides the same session machinery:

- `"palmpay"` appears in `enabled_payment_methods` on the initialize response when it is available.
- You can steer it with `payment_methods` like any other method: an explicit list must include `"palmpay"` to offer it, and `["palmpay"]` alone makes the checkout PalmPay-only. See [choosing payment methods](/payment-methods/overview#how-availability-is-decided).
- A successful payment fires the same [`charge.success`](/webhooks/events#charge-success) webhook with `channel: "palmpay"`.
- [Verify](/api/verify-session) works unchanged; the session reports `completed` once the payment confirms.
- Invoices record PalmPay payments like any other method, so `invoice.paid` and `invoice.payment_received` fire as usual.

## Amounts, fees, settlement

- NGN only, same minimum as the rest of checkout (₦100).
- Fees follow the pricing configured for your account.
- Settlement is our standard T+1 schedule, to your existing settlement destination (bank or ZevPay balance). Nothing about your payout setup changes.

## Reliability

Payment confirmation is webhook-driven with an automatic reconciliation sweep behind it, so a completed PalmPay payment confirms your checkout even if a notification is delayed. If a customer reports paying without the page confirming, the payment resolves automatically within minutes and appears in your dashboard like any other.