Changelog
Back to All
Added

List a user's saved PayNearMe payout methods in the embedded UI

November 2nd, 2026 by ReadMe API

Availability: Sandbox since October 27, 2026 · Production: not yet released

A new endpoint, GET /embed/v1/payment/pnm/withdraw/methods, lists the cards a user has saved with PayNearMe that can receive a payout. Use it to render your own payout picker, then pass the chosen paymentMethodIdentifier to POST /embed/v1/payment/pnm/withdraw.

The endpoint requires the withdraw-pnm-card permission, the same as the existing PayNearMe withdrawal endpoints. It returns methods, which is an empty array when the user has no saved payout methods. Each method contains:

  • paymentMethodIdentifier
  • accountType
  • name
  • description, PayNearMe's label for the method, usually the issuing bank
  • last4

If PayNearMe cannot list the methods, the endpoint returns 502 with code: pnm_find_payment_methods_failed. Retrying is safe. It returns 503 with code: tenant_unavailable when withdrawals are not available right now. Retry later in that case.

See Embedded UI for details on /embed/v1 tokens and permissions.