Recebíveis

O saldo da Pagar.me é construído sobre recebíveis, também chamados de payables, a representação do compromisso da Pagar.me com os seus clientes. Cada recebível representa um valor adicionado ou retirado do saldo total da conta Pagar.me. Existem 5 tipos de recebíveis distintos, sendo eles: credit, refund, refund_reversal, chargeback e chargeback_refund. Recebíveis do tipo credit, refund_reversal e chargeback_refund adicionarão ao saldo enquanto recebíveis de refund e chargeback reduzirão o saldo.

Segue um exemplo de recebível:

{
    "object": "payable",
    "id": 11814386,
    "status": "waiting_funds",
    "amount": 10000,
    "fee": 500,
    "anticipation_fee": 0,
    "fraud_coverage_fee": 0,
    "installment": 1,
    "transaction_id": 9842817,
    "split_rule_id": null,
    "bulk_anticipation_id": null,
    "recipient_id": "re_cjsklmm5k00qu2j6exqej7tss",
    "originator_model": null,
    "originator_model_id": null,
    "payment_date": "2020-10-26T03:00:00.000Z",
    "original_payment_date": null,
    "type": "credit",
    "payment_method": "credit_card",
    "accrual_date": "2020-09-23T21:02:29.679Z",
    "date_created": "2020-09-23T21:02:29.860Z"
}

Explicação de cada parâmetro:

PropriedadeDescrição
objectDefinição da informação retornada
idIdentificador do recebível
statusSituação do recebível
amountValor do recebível em centavos
feeTaxa do recebível
anticipation_feeTaxa de antecipação do recebível
fraud_coverage_feeTaxa de cobertura de fraude
installmentDefine de qual parcela da transação esse recebível foi originado
transaction_idRepresenta o identificador da transação que originou o recebível
split_rule_idRepresenta o identificador de regra de split atrelada a esse recebível
bulk_anticipation_idRepresenta o identificador de antecipação caso o recebível tenha sido antecipado
recipient_idRecebedor ao qual aquele recebível está atrelado
originator_modelPara payables gerados por operações diferentes de transações, como estornos, será preenchido com o tipo de operação que originou esse payable.
originator_model_idCaso o campo originator_model esteja preenchido, o id respectivo daquele model estará presente nesse campo.
payment_dateData de pagamento do recebível
original_payment_dateData de pagamento original do recebível (só é preenchido no caso de recebíveis antecipados)
typeTipo do recebível
payment_methodMétodo de pagamento do recebível
accrual_dateData que o recebível foi criado
date_createdData que o recebível foi registrado

Tipos de recebíveis

Recebíveis de crédito

Um recebível de crédito (credit) é criado toda vez que uma transação é paga com sucesso. Em uma transação parcelada cada parcela irá gerar um recebível diferente, sendo que cada um desses possui uma data de pagamento diferente, seguindo a fórmula: ((nº da parcela * 30 dias)-1)+ 2 dias úteis. Dessa forma uma transação parcelada em 3 vezes teria cada parcela compensada em uma data distinta, 1ª parcela em 29 dias + 2 dias úteis, 2ª parcela em 59 dias + 2 dias úteis e 3ª parcela em 89 dias + 2 dias úteis. Lembrando que esse é o fluxo natural de pagamento, havendo maneiras de antecipar a compensação desses valores, para mais detalhes confira a nossa central de ajuda: https://pagarme.zendesk.com/hc/pt-br/categories/201944703-Antecipação.

É importante se atentar que utilizando o modelo de marketplace, com vários recebedores atrelados a uma única transação, será criado 1 recebível distinto para cada recebedor, ainda respeitando a regra de parcelas. Então no caso de uma transação dividida entre 3 recebecedores parcelada em 5 vezes, essa única transação irá gerar 15 recebíveis, 5 para cada recebedor.

Recebíveis de estorno

Existem dois tipos de recebíveis que estão atrelados a operação de estorno, são esses os recebíveis dos tipos "refund" e "refund_reversal". Os recebíveis do tipo "refund" são gerados quando o estorno de uma transação é solicitado, seja ele parcial ou total. Estornos totais geram um único recebível com o valor total da transação, enquanto estornos parciais geram um recebível para cada parcela, diluindo o valor do estorno igualmente de cada uma delas. Já recebíveis do tipo "refund_reversal" são gerados quando um estorno falha, assim devolvendo o saldo que havia sido retirado do saldo do recebedor.

Recebíveis de chargeback

Recebíveis de chargeback estão relacionados a contestação de uma transação pelo portador do cartão. Os recebíveis do tipo "chargeback" serão lançados como descontos no saldo, enquanto recebíveis do tipo "chargeback_refund" serão créditos. O recebível do tipo "chargeback_refund" é gerado quando um chargeback é devidademente revertido através do processo de disputa. Para mais detalhes sobre chargebacks acesse a nossa central de ajuda: https://pagarme.zendesk.com/hc/pt-br/categories/115000103586-Chargebacks-e-Reapresentações

Status de um recebível

Um recebível pode possuir 3 status distintos, sendo eles: waiting_funds, prepaid e paid. Recebíveis "waiting_funds" são aqueles que serão pagos no futuro. Recebíveis "prepaid" são aqueles que serão pagos no dia seguinte. Recebíveis "paid" são aqueles que já foram pagos.