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.
URL de base
- UAT :
https://transactions.transactional.uat.unico.app/api/public/v1 - Production :
https://transactions.transactional.unico.app/api/public/v1
Demander une analyse de chargeback
POST /credit/transactions/{transaction_id}/chargeback — demande une analyse de chargeback pour une transaction spécifiée.
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",
"documents": [
{ "label": "FILE_NAME", "data": "JVBERi0xLjQKMSAwI==" }
]
}
| Champ | Type | Requis | Description |
|---|---|---|---|
datetime | string | oui | Date et heure de la demande de 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 de la demande de chargeback. |
observation | string | non | Observations générales sur la demande. |
documents | array | non | Documents liés au chargeback. Jusqu'à 3 éléments, chacun encodé en Base64 — PDF uniquement. |
documents[].label | string | oui (par élément) | Nom ou description du fichier. |
documents[].data | string | oui (par élément) | Fichier PDF encodé en Base64. |
200 OK
{
"id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}
| Champ | Description |
|---|---|
id | ID de chargeback généré. |
Pour les réponses d'erreur, consultez Erreurs — Création de transaction.
Obtenir le statut de l'analyse de 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. |
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.