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.

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.
• A successful payment fires the same charge.success webhook with channel: "palmpay".
• Verify 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.