Skip to main content
The native SDKs provide a convenient way to retrieve all stored payment methods for a specific buyer, filtered by the checkout’s currency and country. This allows you to display previously saved payment methods to returning customers for a faster checkout experience.

Use cases

List buyer payment methods to:
  • Display saved payment methods to returning customers
  • Allow buyers to select from their stored cards and payment methods
  • Filter payment methods by country and currency for the current checkout
  • Show payment method details (last 4 digits, expiration date, card brand)
  • Sort payment methods by last used date or other criteria

Implementation

Create a request with buyer identification (buyer ID or external identifier) and optional filters to retrieve stored payment methods.

Best practices

  • Buyer identification: Use either buyerId (internal Gr4vy ID) or buyerExternalIdentifier (your system’s ID) to identify the buyer.
  • Filter appropriately: Apply country and currency filters to show only payment methods relevant to the current transaction.
  • Sort by usage: Sort by lastUsedAt to show the most recently used payment methods first for better user experience.
  • Error handling: Always handle network and HTTP errors gracefully and show appropriate messages to users.
  • Timeout configuration: Use custom timeouts for payment methods requests if your network conditions require it.
  • Display clearly: Show payment method details (card brand, last 4 digits, expiration date) to help users identify their preferred method.