Author Image

xossy_

Sep 2, 2022

Verificação de Pagamento em Cobrança Recorrente

cobrança recorrentenotificação de assinaturasendpointassinaturascobrançaEfí Pay

Na cobrança recorrente como sabemos se um determinado mês foi pago, tem algum endpoint que faz isso?

Respostas (2):
Avatar discord do usuario guilherme_efi

guilherme_efi

02/09/2022

@Xossy Quando você criar uma assinatura você utiliza o parâmetro metadata>notification_url definindo uma URL de retorno.
Assim a cada cobrança que for criada e paga, mensalmente por exemplo, será enviado uma notificação para seu sistema com o notification_token da assinatura (https://dev.gerencianet.com.br/docs/entendendo-fluxo-notificacoes).
Ao receber o notification_token, seu sistema deverá consultá-lo para obter os detalhes da notificação (https://dev.gerencianet.com.br/docs/notificacoes-recebendo#2-consultando-detalhes-de-uma-notifica%C3%A7%C3%A3o), e então obter o json semelhante ao seguinte:

json
{
"code": 200,
"data": [
{
"id": 1,
"type": "subscription",
"custom_id": null,
"status": {
"current": "new",
"previous": null
},
"identifiers": {
"subscription_id": 11976
},
"created_at": "2017-07-20 00:20:16"
},
{
"id": 2,
"type": "subscription",
"custom_id": null,
"status": {
"current": "new_charge",
"previous": "new"
},
"identifiers": {
"subscription_id": 11976
},
"created_at": "2017-07-20 00:20:16"
},
{
"id": 3,
"type": "subscription_charge",
"custom_id": null,
"status": {
"current": "new",
"previous": null
},
"identifiers": {
"subscription_id": 11976,
"charge_id": 2396478
},
"created_at": "2017-07-20 00:20:16"
}
]
}
neste Json você vai capturar o array com que te mostra todo histórico da assinatura.

Então você deverá capturar em cada laço desse json. Se o laço conter o "type": "subscription", significa que ele se refere a um registro de alteração da assinatura.
Se em outro laço conter o "type": "subscription_charge", significa que ele se refere a um registro de alteração de uma cobrança, então você poderá verificar o status>current, subscription_id a qual se refere.

Veja o exemplo completo da resposta ao consultar o token de notificação de uma assinatura: https://dev.gerencianet.com.br/docs/notificacoes-recebendo#21-exemplos-de-respostas

Avatar discord do usuario guilherme_efi

guilherme_efi

02/09/2022

Ou você pode consulta a assinatura a partir de seu id
https://dev.gerencianet.com.br/docs/assinaturas-outros-endpoints#3-retornar-informa%C3%A7%C3%B5es-de-assinatura-vinculada-a-um-plano

A Comunidade Efí no Discord reúne mais de 11382 desenvolvedores 👨‍💻 incríveis.

Participe para se manter atualizado sobre as APIs da Efí Pay, tirar dúvidas e muito mais! 😊

📰 Discussões relacionadas