Skip to main content
Version: v1

Delete Payment Method

The Delete Payment Method API allows merchants to remove a payment method (card or bank account) from a customer profile using the merchant-wallet-management or user scope. This API is used to delete payment methods from the wallet securely.

Quick Reference
  • API Endpoint: DELETE v1/payment-methods/{paymentMethodId}
  • Supported Scope: merchant-wallet-management, user
    • Allowed Session Modes: PAYMENT_WITH_WALLET, WALLET
  • Key Fields: agent
  • Behavior:
    • Removes a payment method from the customer wallet
  • Error Codes: Refer Delete Payment Method Error Codes
  • Notifications: Refer Webhooks

Handling Delete Payment Method​

  • Remove a card or bank account from a customer wallet
  • Restricted by merchant configuration (e.g., only cards or only bank accounts)
    • ⚠️ Merchant with CARD configuration will not be able to delete BANK_ACCOUNT from customer wallet

Sample Request​

Sample Request – Delete Payment Method
{
  "firstName": "string",
  "lastName": "string",
  "userId": "string",
  "isAccessVerified": true
}

Notifications​

PAYMENT_METHOD_DELETED event will be triggered to merchants if requested. Refer Webhooks

Error Handling​

Refer Delete Payment Method Error Codes