Skip to main content
Cria um novo método de pagamento de cartão de crédito ou PIX para um cliente.

​
Criar com Cartão de Crédito

curl -X POST https://api.upag.io/v1/customers/cus_ahwDXrgYvur89iPs/payment-methods \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "credit_card",
    "card": {
      "number": "4111111111111111",
      "expiryMonth": "12",
      "expiryYear": "2025",
      "cvv": "123",
      "holderName": "JOHN DOE"
    }
  }'

​
Parâmetros para Cartão

​
customerId
string
required
ID do cliente.
​
type
string
required
Tipo do método de pagamento. Deve ser credit_card.
​
card.number
string
required
Número do cartão (13 a 19 dígitos).
​
card.expiryMonth
string
required
Mês de expiração (1-2 dígitos).
​
card.expiryYear
string
required
Ano de expiração (4 dígitos).
​
card.cvv
string
required
Código de segurança (3-4 dígitos).
​
card.holderName
string
required
Nome do portador do cartão (máximo 255 caracteres).

​
Resposta

Response
{
  "id": "pm_abc123xyz",
  "livemode": false,
  "type": "credit_card",
  "expiresIn": null,
  "expiryMonth": "12",
  "expiryYear": "2025",
  "firstDigits": "4111",
  "lastDigits": "1111",
  "brand": "visa",
  "holderName": "JOHN DOE",
  "createdAt": 1731622178441,
  "updatedAt": 1731622178441
}

​
Criar com PIX

curl -X POST https://api.upag.io/v1/customers/cus_ahwDXrgYvur89iPs/payment-methods \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "pix",
    "pix": {
      "expiresIn": 600
    }
  }'

​
Parâmetros para PIX

​
customerId
string
required
ID do cliente.
​
type
string
required
Tipo do método de pagamento. Deve ser pix.
​
pix.expiresIn
number
Tempo de expiração em segundos. Padrão: 600 (10 minutos). Mínimo: 60, Máximo: 2592000 (30 dias).

​
Resposta

Response
{
  "id": "pm_pix123xyz",
  "livemode": false,
  "type": "pix",
  "expiresIn": 600,
  "expiryMonth": null,
  "expiryYear": null,
  "firstDigits": null,
  "lastDigits": null,
  "brand": null,
  "holderName": null,
  "createdAt": 1731622178441,
  "updatedAt": 1731622178441
}