Skip to main content
Cria um novo pagamento para um cliente usando um método de pagamento previamente cadastrado.

​
Endpoint

curl -X POST https://api.upag.io/v1/payments \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_ahwDXrgYvur89iPs",
    "paymentMethod": "pm_abc123xyz",
    "amount": 10000,
    "currency": "BRL",
    "installments": 1
  }'

​
Parâmetros

​
customer
string
required
ID do cliente (UUID).
​
paymentMethod
string
required
ID do método de pagamento (UUID).
​
amount
number
required
Valor do pagamento em centavos (mínimo: 1).
​
currency
string
required
Código da moeda (ex.: BRL).
​
installments
number
Número de parcelas. Padrão: 1, máximo: 12.

​
Resposta

Response
{
  "id": "pay_xyz789abc",
  "livemode": false,
  "customer": {
    "id": "cus_ahwDXrgYvur89iPs",
    "name": "John Doe",
    "email": "[email protected]"
  },
  "paymentMethod": {
    "id": "pm_abc123xyz",
    "type": "credit_card",
    "lastDigits": "1111",
    "brand": "visa"
  },
  "amount": 10000,
  "gross": 10000,
  "mdr": 0,
  "net": 10000,
  "interest": 0,
  "currency": "BRL",
  "status": "paid",
  "pixQrCode": null,
  "refuseReason": null,
  "installments": 1,
  "createdAt": 1731622178441,
  "updatedAt": 1731622178441,
  "dueAt": null
}