---
title: "Cancel a payment method"
method: POST
path: "/v1/payment_methods/{id}/cancel"
tags: ["Payment Methods"]
---

# Cancel a payment method

`POST /v1/payment_methods/{id}/cancel`

## Request

- Base URL: `https://orders-api.paymongo.com`
- URL: `https://orders-api.paymongo.com/v1/payment_methods/{id}/cancel`
- Auth: HTTP basic

Cancels a payment method at the service that decides it (`processed_by`), revoking a wallet binding; a card's cancel changes nothing, as on core-api. Answers the method in core-api's response shape.

## Path parameters

- `id` string, required

## Response `200`

OK

- PaymentMethodResponse
  - `data` object
    - `attributes` PaymentMethodAttributes
      - `billing` Billing
        - `address` BillingAddress
          - `city` string
          - `country` string
          - `line1` string
          - `line2` string
          - `postal_code` string
          - `state` string
        - `email` string
        - `name` string
        - `phone` string
      - `created_at` integer
      - `details` object: Relayed from the method service, like NextAction.
      - `expiry_seconds` integer: The one field legacy itself guards on presence.
      - `livemode` boolean
      - `metadata` object
      - `type` string
      - `updated_at` integer
    - `id` string
    - `type` string

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `default`

---

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