Chargeback

Markdown

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.

URL de base

• 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.

Signaler n'est pas contester

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êtes

En-tête	Valeur
Authorization	Bearer {token} — un jeton d'accès valide.

Corps

{
  "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.

201 Created

{
  "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êtes

En-tête	Valeur
Authorization	Bearer {token} — un jeton d'accès valide.

200 OK

{
  "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.