Cobrança
Consulte o contrato e um exemplo de cada operação, sem percorrer uma lista inteira.
Neste artigo
Operações e exemplos
Abra a página do recurso desejado no menu lateral ou nos links abaixo. O exemplo pode ser copiado nas linguagens disponíveis. Os exemplos são referências e não executam chamadas automaticamente.
/api/plansPlanos públicos
Lista planos públicos, recursos, preços e disponibilidade de checkout.
const response = await fetch('https://runixcloud.online/api/plans', {
method: 'GET',
});
console.log(await response.text());/api/billingResumo da cobrança
Retorna plano atual, vigência e histórico recente de cobranças.
const response = await fetch('https://runixcloud.online/api/billing', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/billing/coupons/previewValidar cupom
Valida um cupom no servidor e retorna valor original, desconto e total final. Cupons recorrentes ativos também podem ser aplicados automaticamente.
{
"plan_id": "uuid-do-plano",
"cycle": "monthly",
"code": "RUNIX20"
}const response = await fetch('https://runixcloud.online/api/billing/coupons/preview', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"plan_id": "uuid-do-plano",
"cycle": "monthly",
"code": "RUNIX20"
})
});
console.log(await response.text());/api/billing/checkout/:planIdIniciar Checkout Pro
Cria uma preferência no Mercado Pago e uma ordem local vinculada ao usuário.
{
"cycle": "monthly"
}const response = await fetch('https://runixcloud.online/api/billing/checkout/:planId', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"cycle": "monthly"
})
});
console.log(await response.text());/api/billing/orders/:idConsultar cobrança
Consulta o estado da ordem local. Pagamentos aprovados em espera podem ser reconciliados novamente.
const response = await fetch('https://runixcloud.online/api/billing/orders/SERVER_ID', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/webhooks/mercadopagoWebhook Mercado Pago
Recebe eventos de pagamento, valida X-Signature e consulta o pagamento no Mercado Pago antes de entregar o plano.
const response = await fetch('https://runixcloud.online/api/webhooks/mercadopago', {
method: 'POST',
});
console.log(await response.text());