Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feature/notifications-chargebacks #2494

Open
wants to merge 1 commit into
base: development
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion guides/additional-content/chargebacks/how-to-manage.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ A dispute occurs when **you want to argue the chargeback claim** with supporting

All the information necessary to manage chargeback disputes made can be found here:

1. Configure [IPN notifications](/developers/panel/ipn) on your dashboard and enable the **Chargebacks** option
1. Configure [Webhooks](/developers/en/docs/checkout-pro/additional-content/your-integrations/notifications/webhooks) or [IPN notifications](/developers/panel/ipn) on your dashboard and enable the **Chargebacks** option.

2. Check all the information related to a chargeback using the [Get chargeback request](/developers/en/reference/chargebacks/_chargebacks_id/get)
1. Check if the chargeback [can be covered](https://www.mercadopago[FAKER][URL][DOMAIN]/ajuda/294) and assure whether any documentation is required, via the `coverage_eligible` and `documentation_required` fields, respectively.
Expand Down
4 changes: 2 additions & 2 deletions guides/additional-content/chargebacks/how-to-manage.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ Se produce una disputa cuando deseas discutir el reclamo de contracargo con info

Toda la información necesaria para gestionar las disputas de contracargos realizadas se puede encontrar aquí:

1. Configura [las notificaciones IPN](/developers/panel/ipn) y habilita la opción **Contracargos**
1. Configura [notificaciones Webhooks](/developers/es/docs/checkout-pro/additional-content/your-integrations/notifications/webhooks) o [IPN](/developers/panel/ipn) y habilita la opción **Contracargos**.

2. Verifica toda la información relacionada con un contracargo utilizando la solicitud [Obtener contracargo](/developers/es/reference/chargebacks/_chargebacks_id/get)
2. Consulta toda la información relacionada con un contracargo utilizando la solicitud [Obtener contracargo](/developers/es/reference/chargebacks/_chargebacks_id/get).
1. Verifica si el [contracargo se puede cubrir](https://www.mercadopago[FAKER][URL][DOMAIN]/ayuda/294) y si se requiere alguna documentación, a través de los campos `coverage_eligible` y `documentation_required`, respectivamente.

> WARNING
Expand Down
2 changes: 1 addition & 1 deletion guides/additional-content/chargebacks/how-to-manage.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Uma disputa ocorre quando **você deseja argumentar** o pedido de contestação

Abaixo você encontra as informações necessárias para o gerenciamento das disputas das contestações feitas.

1. Configure as [notificações IPN](/developers/panel/ipn) no painel e ative a opção **Contestações (chargebacks)**
1. Configure as [notificações Webhooks](/developers/pt/docs/checkout-pro/additional-content/your-integrations/notifications/webhooks) ou [IPN](/developers/panel/ipn) no painel e ative a opção **Chargebacks**.

2. Consulte todas as informações de uma contestação com o método [Obter estorno](/developers/pt/reference/chargebacks/_chargebacks_id/get)
1. Identifique se a contestação é [elegível a cobertura](https://www.mercadopago[FAKER][URL][DOMAIN]/ajuda/294) e se é necessário apresentar alguma documentação, através dos campos `coverage_elegible` e `documentation_required`, respectivamente.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,33 @@ In cases where notifications for the topic `topic_claims_integration_wh` have be
| `type` | Type of notification received, according to the previously selected topic. In this case, it will always be `claim`. |
| `user_id `| User identifier for whom the notification is sent. |

## Chargebacks

In cases where notifications for the topic `topic_chargebacks_wh` have been activated, a Webhooks notification will be sent when a chargeback is initiated or its status is changed, as shown below:

```json
{
"actions":["changed_case_status"],
"api_version":"v1",
"application_id":9007201037432480,
"data":{
"checkout":"PRO",
"date_updated":"0001-01-01T00:00:00Z",
"id":217000061307271000,
"payment_id":81034165129,
"product_id":"BC32A57TRPP001U8NHHG",
"site_id":"MLA",
"transaction_intent_id":""
},
"date_created":"2024-07-02T22:03:24-04:00",
"id":114544942708,
"live_mode":true,
"type":"topic_chargebacks_wh",
"user_id":425424311,
"version":1720427447
}
```

## Offline payment methods

If you have integrated payments with offline payment methods and configured your notifications with the payments topic, you should know that all changes in payment status will be notified to you.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,34 @@ En los casos en los que se hayan activado las notificaciones para el tópico `to
| `type` | Tipo de notificación recibida, de acuerdo al tópico seleccionado previamente. En este caso, será siempre `claim`. |
| `user_id `| Identificador del usuario para el que se envía la notificación. |

## Contracargos

En los casos en los que se hayan activado las notificaciones para el tópico `topic_chargebacks_wh`, se enviará una notificación Webhooks cuando se inicie un contracargo o cambie su estado, tal como se muestra a continuación:

```json
{
"actions":["changed_case_status"],
"api_version":"v1",
"application_id":9007201037432480,
"data":{
"checkout":"PRO",
"date_updated":"0001-01-01T00:00:00Z",
"id":217000061307271000,
"payment_id":81034165129,
"product_id":"BC32A57TRPP001U8NHHG",
"site_id":"MLA",
"transaction_intent_id":""
},
"date_created":"2024-07-02T22:03:24-04:00",
"id":114544942708,
"live_mode":true,
"type":"topic_chargebacks_wh",
"user_id":425424311,
"version":1720427447
}
```


## Medios de pago offline

En caso de haber integrado medios de pago offline y configurado tus notificaciones con el tópico `payments`, todos los cambios de estado de un pago te serán notificados.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,34 @@ Nos casos em que as notificações para o tópico `topic_claims_integration_wh`
| `type` | Tipo de notificação recebida, conforme o tópico selecionado anteriormente. Neste caso, será sempre `claim`. |
| `user_id `| Identificador do usuário para quem a notificação está sendo enviada. |

## Chargebacks

Nos casos em que as notificações para o tópico `topic_chargebacks_wh` estiverem ativadas, uma notificação Webhooks será enviada quando um _chargeback_ for iniciado, ou seu status atualizado, conforme mostrado abaixo:

```json
{
"actions":["changed_case_status"],
"api_version":"v1",
"application_id":9007201037432480,
"data":{
"checkout":"PRO",
"date_updated":"0001-01-01T00:00:00Z",
"id":217000061307271000,
"payment_id":81034165129,
"product_id":"BC32A57TRPP001U8NHHG",
"site_id":"MLA",
"transaction_intent_id":""
},
"date_created":"2024-07-02T22:03:24-04:00",
"id":114544942708,
"live_mode":true,
"type":"topic_chargebacks_wh",
"user_id":425424311,
"version":1720427447
}
```


## Meios de pagamento offline

Se você integrou meios de pagamento offline e configurou suas notificações com o tópico `payments`, todas as mudanças de status de um pagamento serão notificadas a você.
Expand Down