Skip to main content
Uma cobrança é um portal onde seu cliente pode realizar um pagamento sem interrupções. Tipos de cobrança:
  • ONE_TIME: Cobrança que aceita um único pagamento do mesmo cliente.
  • MULTIPLE_PAYMENTS: Cobrança em modo link de pagamento, aceita vários pagamentos de clientes diferentes.

​
Estrutura

Uma cobrança é representada em nossa API pela seguinte estrutura:
json
{
  "id": "bill_uA0M0xwg5R4mSyr0n2PjHQXY",
  "frequency": "ONE_TIME",
  "url": "https://abacatepay.com/pay/bill_uA0M0xwg5R4mSyr0n2PjHQXY",
  
  "status": "PAID",
  "devMode": true,
  "methods": ["PIX"],
  "products": [
    {
      "id": "prod_dNFbdDjfpaegmzBWWdNM2Huw",
      "externalId": "prod-1234",
      "quantity": 1
    }
  ],
  "customer": {
    "id": "cust_aebxkhDZNaMmJeKsy0AHS0FQ",
    "metadata": {
      "name": "Test Customer",
      "cellphone": "11999999999",
      "taxId": "12345678900",
      "email": "test@example.com"
    }
  },
  "metadata": {
    "fee": 100,
    "returnUrl": "https://example.com/billing",
    "completionUrl": "https://example.com/completion"
  },
  "nextBilling": null,
  "allowCoupons": false,
  "coupons": [],
  "createdAt": "2024-12-06T18:56:15.538Z",
  "updatedAt": "2024-12-06T18:56:15.538Z"
}

​
Atributos:

json
{
"id": "bill_uA0M0xwg5R4mSyr0n2PjHQXY",
}
id : string.
Id único da cobrança na AbacatePay
json
{
"frequency": "ONE_TIME",
}
frequency : string.
Frequência da cobrança. Pode ser ONE_TIME ou MULTIPLE_PAYMENTS.
ONE_TIMECobrança que aceita um único pagamento do mesmo cliente.
MULTIPLE_PAYMENTSCobrança em modo link de pagamento, aceita vários pagamentos de clientes diferentes.
json
 {
   "url": "https://abacatepay.com/pay/bill_uA0M0xwg5R4mSyr0n2PjHQXY",
 }
url : string.
URL para seu cliente executar o pagamento da cobrança
json
{
  "status": "PAID",
}
status : string.
Status da cobrança. Pode ser PENDING, EXPIRED, CANCELLED, PAID, REFUNDED
PENDINGA cobrança está com o pagamento pendente
EXPIREDO tempo limite de pagamento foi excedido
CANCELLEDA cobrança foi cancelada por você
PAIDA cobrança foi paga com sucesso pelo cliente
REFUNDEDO valor foi devolvido ao cliente
json
 {
   "methods": ["PIX", "CARD"],
 }
methods : array
Tipos de pagamento suportados: PIX e CARD (beta).

Cartão de crédito (beta)

Pagamentos por cartão estão em beta. Para habilitar, entre em contato com o suporte: ajuda@abacatepay.com
json
 {
 "products":
 [
   {
     "id": "prod_dNFbdDjfpaegmzBWWdNM2Huw",
     "externalId": "prod-1234",
     "quantity": 1
   }
 ],
 }
products : array
Lista de produtos inclusos na cobrança
json
{
  "customer": {
    "id": "cust_aebxkhDZNaMmJeKsy0AHS0FQ",
    "metadata": {
      "name": "Test Customer",
      "cellphone": "11999999999",
      "taxId": "12345678900",
      "email": "test@example.com"
    }
  }
}
customer : object
Cliente que você está cobrando. Opcional. Veja referência da estrutura aqui
json
{
  "metadata": {
    "fee": 100,
    "returnUrl": "https://example.com/billing",
    "completionUrl": "https://example.com/completion"
  }
}
metadata : object
Objeto com metadados sobre a cobrança
  • fee number Taxa aplicada pela AbacatePay
  • returnUrl string URL que o cliente será redirecionado ao clicar no botão “voltar”
  • completionUrl string URL que o cliente será redirecionado ao realizar o pagamento
json
{
  "nextBilling": null,
}
nextBilling : date-time | null.
Data e hora da próxima cobrança, ou null para cobranças únicas
json
{
  "allowCoupons": false,
}
allowCoupons : bool | null.
Permite ou não cupons para a cobrança
json
{
  "coupons": [],
}
coupons : array
Cupons permitidos na cobrança. Só são considerados os cupons se allowCoupons é verdadeiro.