Criar Método de Pagamento
curl --request POST \
--url https://api.billing.upag.io/v1/customers/{customerId}/payment-methods \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "<string>",
"card.number": "<string>",
"card.expiryMonth": "<string>",
"card.expiryYear": "<string>",
"card.cvv": "<string>",
"card.holderName": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: '<string>',
'card.number': '<string>',
'card.expiryMonth': '<string>',
'card.expiryYear': '<string>',
'card.cvv': '<string>',
'card.holderName': '<string>'
})
};
fetch('https://api.billing.upag.io/v1/customers/{customerId}/payment-methods', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.billing.upag.io/v1/customers/{customerId}/payment-methods';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: '<string>',
'card.number': '<string>',
'card.expiryMonth': '<string>',
'card.expiryYear': '<string>',
'card.cvv': '<string>',
'card.holderName': '<string>'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Métodos de Pagamento
Criar Método de Pagamento
Crie um método de pagamento (cartão ou PIX) para um cliente
POST
https://api.billing.upag.io
/
v1
/
customers
/
{customerId}
/
payment-methods
Criar Método de Pagamento
curl --request POST \
--url https://api.billing.upag.io/v1/customers/{customerId}/payment-methods \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "<string>",
"card.number": "<string>",
"card.expiryMonth": "<string>",
"card.expiryYear": "<string>",
"card.cvv": "<string>",
"card.holderName": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: '<string>',
'card.number': '<string>',
'card.expiryMonth': '<string>',
'card.expiryYear': '<string>',
'card.cvv': '<string>',
'card.holderName': '<string>'
})
};
fetch('https://api.billing.upag.io/v1/customers/{customerId}/payment-methods', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.billing.upag.io/v1/customers/{customerId}/payment-methods';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: '<string>',
'card.number': '<string>',
'card.expiryMonth': '<string>',
'card.expiryYear': '<string>',
'card.cvv': '<string>',
'card.holderName': '<string>'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));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.billing.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"
}
}'
import { Upag } from 'upag';
const upag = new Upag('sk_test_your_api_key');
const paymentMethod = await upag.paymentMethods.create('cus_ahwDXrgYvur89iPs', {
type: 'credit_card',
card: {
number: '4111111111111111',
expiryMonth: '12',
expiryYear: '2025',
cvv: '123',
holderName: 'JOHN DOE',
},
});
Parâmetros para Cartão
string
required
ID do cliente.
string
required
Tipo do método de pagamento. Deve ser
credit_card.string
required
Número do cartão (13 a 19 dígitos).
string
required
Mês de expiração (1-2 dígitos).
string
required
Ano de expiração (4 dígitos).
string
required
Código de segurança (3-4 dígitos).
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.billing.upag.io/v1/customers/cus_ahwDXrgYvur89iPs/payment-methods \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"type": "pix",
"pix": {
"expiresIn": 600
}
}'
import { Upag } from 'upag';
const upag = new Upag('sk_test_your_api_key');
const paymentMethod = await upag.paymentMethods.create('cus_ahwDXrgYvur89iPs', {
type: 'pix',
pix: { expiresIn: 600 },
});
Parâmetros para PIX
string
required
ID do cliente.
string
required
Tipo do método de pagamento. Deve ser
pix.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
}