---
title: "Revoke a payment method's wallet credential (payments-api provider contract)"
method: DELETE
path: "/v1/instruments/payment_method/{payment_method_id}"
tags: ["instruments"]
---

# Revoke a payment method's wallet credential (payments-api provider contract)

`DELETE /v1/instruments/payment_method/{payment_method_id}`

## Request

- Base URL: `https://ewallets-api.paymongo.com`
- URL: `https://ewallets-api.paymongo.com/v1/instruments/payment_method/{payment_method_id}`
- Auth: HTTP bearer

Called when payments-api cancels a saved wallet method or an off_session intent. Finds the method's active instrument, releases the credential at its wallet (Maya: delete the link; GCash: unbind), marks it revoked, and answers the instrument shape; only data.id is read. No active instrument answers success (nothing left to revoke; a repeat lands here). An instrument of another organization or mode is 404. A wallet that refuses answers 502, never 404: payments-api reads 404 as already gone and would record the method revoked over a live binding.

## Path parameters

- `payment_method_id` string, required

## Headers

- `PayMongo-Livemode` 'true' | 'false', required
- `PayMongo-Correlation-Id` string

## Response `200`

OK

- InstrumentsResponse
  - `data` InstrumentsInstrument
    - `details` object
    - `id` string

## Other responses

- `401`: Missing or invalid service token
- `404`: not_found: the instrument belongs to another organization or mode
- `500`: Internal server error
- `502`: service_unavailable: the wallet refused to release the credential

---

[API](https://skmtc.dev/paymongo/apis/ewallets.md) - [All operations](https://skmtc.dev/paymongo/apis/ewallets/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/ewallets/revisions/a445ca65c132?raw)