Traiter les règlements fractionnés par carte
POST /cardpayments/v1/accounts/account_id/auths/authorization_id/settlements
Comme pour un règlement par carte standard, pour traiter un règlement impliquant des paiements fractionnés, vous devez vous référer à l’identifiant d’autorisation initial et envoyer votre requête POST au point d’extrémité du règlement.
Avant d’essayer l’exemple ci-dessus, vous devez :
- Remplacer le numéro de compte (89987201) dans l’URL par le numéro de compte de test que vous avez reçu.
- Remplacer la clé API (après le -u) par la clé API que vous avez reçue.
curl -X POST https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/auths/6ce78961-5989-4c4b-ad68-5f5af506143e/settlements \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’ {
"merchantRefNum": "merchantRef_2014_04_11_05",
"amount": 5000,
"splitpay": [
{
"linkedAccount": "123124124",
"percent": 5.31
},
{
"linkedAccount": "767862873",
"amount": 500
}
]
}’
Si vous n’indiquez pas de montant total pour le règlement, la totalité du montant restant sur l’autorisation sera définie par défaut.
L’objet splitpay est un ensemble de comptes liés, dont chacun possède les attributs suivants :
| Valeur | Type | Requis? | Description | Exemple |
|---|---|---|---|---|
| linkedAccount | string | Oui | Il s’agit de l’identifiant du compte lié. Ce compte doit déjà être lié au compte du marchand. | 123124124 |
| percent | number | Le pourcentage ou le montant est requis, mais pas les deux. | Le pourcentage du montant total de la transaction à transférer sur le compte lié, jusqu’à deux décimales. Le pourcentage total de tous les comptes liés ne peut dépasser 100 %. | 5,31 |
| montant | integer | Il s’agit du montant à transférer sur le compte lié en unités monétaires mineures. Le montant total de tous les comptes liés ne peut dépasser le total de la transaction. | 500 |
{
"links": [
{
"rel": "self",
"href": "https://api.test.paysafe.com/cardpayments/v1/accounts/89987201/settlements/6ddbc05a-ff40-4dc1-b2d3-f200934dfdde"
}
],
"id": "6ddbc05a-ff40-4dc1-b2d3-f200934dfdde",
"merchantRefNum": "merchantRef_2014_04_11_05",
"txnTime": "2017-04-11T14:04:36Z",
"status": "PENDING",
"amount": 5000,
"availableToRefund": 0,
"splitpay": [
{
"linkedAccount": "123124124",
"percent": 5.31,
"amount": 266
},
{
"linkedAccount": "767862873",
"amount": 500
}
]
}
Un règlement en attente est créé. Pour la plupart des configurations de compte, le règlement reste en attente jusqu’à ce qu’il soit mis en lot à la fin de la journée. Vous pouvez annuler un règlement lorsqu’il a l’état en attente, auquel cas le client n’est pas facturé. Toutefois, une fois que le règlement a été mis en lot, vous ne pouvez pas l’annuler et vous devrez rembourser l’achat.
L’objet splitpay de la réponse est un tableau contenant un ou plusieurs objets de compte lié :
| Valeur | Type | Requis? | Description | Exemple |
|---|---|---|---|---|
| montant | integer | Oui | Il s’agit du montant à transférer sur le compte lié en unités monétaires mineures. Il s’agit soit du « montant » (s’il a été spécifié) dans la requête, soit – si « pourcentage » a été spécifié – du résultat du calcul du pourcentage. | 505 |
| linkedAccount | string | Oui | Il s’agit de l’identifiant du compte lié. Ce compte doit déjà être lié au compte du marchand. | 123124124 |
| percent | number | Non | Le « pourcentage » (s’il est spécifié) dans la requête pour le compte lié, qui est le pourcentage du montant total de la transaction à transférer vers ce compte. Il n’est pas renvoyé si un « montant » a été spécifié dans la requête. | 5,25 |
Voir notre section Référence API pour une liste de tous les attributs et types JSON disponibles dans l’objet « settlement ».