Chargeback
Avant de commencer
Vos requêtes API sont authentifiées à l'aide d'un jeton d'accès. Toute requête qui n'inclut pas un jeton d'accès valide renverra une erreur. Pour en savoir plus, consultez Authentification.
- UAT :
https://transactions.transactional.uat.unico.app/api/public/v1 - Production :
https://transactions.transactional.unico.app/api/public/v1
Signaler un chargeback
POST /credit/transactions/{transaction_id}/chargeback — signale à Unico qu'un chargeback a été reçu pour une transaction spécifiée.
Ce point de terminaison signale uniquement le chargeback. Il n'ouvre pas d'analyse de chargeback et ne déclenche pas la garantie de responsabilité. Pour qu'Unico analyse le chargeback, ouvrez une contestation pour la transaction dans le portail.
| En-tête | Valeur |
|---|---|
Authorization | Bearer {token} — un jeton d'accès valide. |
{
"datetime": "2023-01-05T03:00:00.000Z",
"requestor": { "key": "cpf", "value": "USER_CPF" },
"name": "USER_NAME",
"reason": "REQUEST_REASON",
"observation": "GENERAL_OBSERVATIONS"
}
| Champ | Type | Requis | Description |
|---|---|---|---|
datetime | string | oui | Date et heure de réception du chargeback, au format ISO 8601. |
requestor | object | oui | Informations du demandeur. |
requestor.key | string | oui | Type de clé d'identification du demandeur (par exemple cpf). |
requestor.value | string | oui | Valeur de la clé d'identification du demandeur. |
name | string | oui | Nom du demandeur. |
reason | string | oui | Motif du chargeback. |
observation | string | non | Observations générales sur le chargeback. |
{
"id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}
| Champ | Description |
|---|---|
id | ID du chargeback. |
Une transaction n'a qu'un seul chargeback. Signaler une transaction qui en a déjà un renvoie 200 OK avec l'id du chargeback existant, sans le modifier.
Pour les réponses d'erreur, consultez Erreurs — Création de transaction.
Obtenir le statut du chargeback
GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id} — vérifie le statut d'un chargeback spécifique.
| En-tête | Valeur |
|---|---|
Authorization | Bearer {token} — un jeton d'accès valide. |
{
"id": "8263a268-5388-492a-bca2-28e1ff4a69f0",
"status": "waiting"
}
| Champ | Description |
|---|---|
id | ID du chargeback. |
status | Statut actuel du chargeback. |
Un chargeback signalé reste à waiting. Si la transaction est contestée dans le portail, le même id indique la progression et le résultat de l'analyse. Consultez Énumérations — Résultat du chargeback pour tous les statuts possibles. Pour optimiser les performances, implémentez le Webhook plutôt que d'interroger ce point de terminaison en continu.