Skip to main content
curl -X POST "https://api.chargefy.io/v1/payment-methods/pm_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_123",
    "metadata": {
      "label": "principal"
    }
  }'

{
  "id": "pm_123",
  "object": "payment_method",
  "billing_details": {
    "address": null,
    "email": "cliente@email.com",
    "name": "Ana Silva",
    "phone": null
  },
  "card": {
    "brand": "visa",
    "exp_month": 12,
    "exp_year": 2030,
    "last4": "4242"
  },
  "created_at": "2026-05-16T18:30:00Z",
  "customer": "cus_123",
  "livemode": true,
  "metadata": {
    "label": "principal"
  },
  "type": "credit_card",
  "updated_at": "2026-05-16T18:45:00Z"
}
Atualiza campos editáveis de um payment_method. Hoje o campo editável é metadata.
​
id
string
required
ID do payment method (pm_*).
​
customer
string
Customer usado como contexto quando necessário.
​
metadata
object
Metadata livre.
curl -X POST "https://api.chargefy.io/v1/payment-methods/pm_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_123",
    "metadata": {
      "label": "principal"
    }
  }'

​
Resposta

200 OK com o objeto payment_method completo — mesmo shape de GET /v1/payment-methods/:id. 
{
  "id": "pm_123",
  "object": "payment_method",
  "billing_details": {
    "address": null,
    "email": "cliente@email.com",
    "name": "Ana Silva",
    "phone": null
  },
  "card": {
    "brand": "visa",
    "exp_month": 12,
    "exp_year": 2030,
    "last4": "4242"
  },
  "created_at": "2026-05-16T18:30:00Z",
  "customer": "cus_123",
  "livemode": true,
  "metadata": {
    "label": "principal"
  },
  "type": "credit_card",
  "updated_at": "2026-05-16T18:45:00Z"
}