Partenaires Alliance – Gestion des flux financiers des submerchants
1. Récupérer les submerchants
Requête
Dans cet exemple de requête, nous récupérons tous les submerchants liés à un compte Alliance en utilisant l’endpoint Alliance::getMerchants. Cet appel peut être effectué avec le token du partenaire Alliance.
Aucun champ obligatoire n’est donc requis et l’appel récupère automatiquement tous les codes M (submerchants) associés au compte Alliance.
Il est possible de filtrer les résultats par statut.
Code de requête : Récupérer la liste des merchants via l’API
curl --request POST
--url https://rest-api.pay.nl/v6/Alliance/getMerchants/json
--header 'authorization: Basic dG9rZW46PHlvdXItYXBpLXRva2VuPg=='
--header 'cache-control: no-cache'
--header 'content-type: application/x-www-form-urlencoded'
--data-urlencode 'state=accepted'
Paramètres
| Paramètre | Type | Champ | Description |
|---|---|---|---|
| state | array | OPTIONNEL | Statut des merchants à renvoyer dans la liste. Valeurs possibles : new accepted deleted |
Réponse
Réponse : Alliance::addMerchant
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
[
{
"merchantId": ""M-####-####"",
"merchantName": "",
"packageType": "",
"invoiceAllowed": "M-####-####",
"payoutInterval": "***********",
"createdDate": "***********",
"acceptedDate": "***********",
"deletedDate": "***********",
"services": [
{
"serviceId": "A-####-####",
"serviceName": "director@classic-carparts.nl"
},
{
"serviceId": "A-####-####",
"serviceName": "finance@classic-carparts.nl"
}
]
}
]
2. Récupérer les rapports de transactions de vos merchants
Pour un démarrage rapide, consultez l’exemple dans le php SDK ou utilisez Statistics::Management.
Documentation complète disponible prochainement
3. Effectuer les versements via votre propre système
Lorsque vous initiez un versement via l’API Merchant::addClearing en tant que merchant ou partenaire, cela peut entraîner une différence entre le montant du versement et le total des transactions figurant sur la facture de clearing. L’exemple ci-dessous explique ce fonctionnement.
3.1 Exemple
Supposons qu’un merchant dispose du solde comptable suivant :
| Type de paiement | Nombre | Montant |
|---|---|---|
| iDEAL | 50 | € 5.000 |
| Carte bancaire | 10 | € 2.000 |
| Bancontact | 5 | € 2.500 |
| Virement bancaire | 5 | € 500 |
| Total | € 10.000 |
Le partenaire initie un clearing via l’API pour un montant de € 6.000.
Que se passe-t-il ?
- Le solde disponible est de € 10.000.
- Le partenaire souhaite verser seulement € 6.000.
- Les transactions à l’origine de ce solde n’ont toutefois pas encore été intégrées dans un clearing.
Afin d’afficher une ventilation correcte sur la facture de clearing et de permettre le rapprochement des transactions, nous procédons comme suit.
La solution sur la facture de clearing
- Nous créons une ligne supplémentaire « Solde initial du clearing » de € -4.000 afin de réduire le solde au montant souhaité.
- Nous générons ensuite le clearing avec cette ligne supplémentaire, ce qui donne un montant de clearing correct de € 6.000 (€ 10.000 moins € 4.000).
- Après cela, nous créons une seconde ligne intitulée « Solde final du clearing » de € +4.000 afin de compenser le solde initial. Le solde restant de € 4.000 est ainsi rétabli.
Exemple sur la facture de clearing
| Type de paiement | Nombre | Montant |
|---|---|---|
| iDEAL | 50 | € 5.000 |
| Carte bancaire | 10 | € 2.000 |
| Bancontact | 5 | € 2.500 |
| Virement bancaire | 5 | € 500 |
| Pay.paiement – Solde initial du clearing | 1 | - € 4.000 |
| Total | € 6.000 |
Le solde final du clearing apparaît ensuite comme correction afin de compenser le solde initial. Lors d’un clearing suivant, ce montant est repris comme montant de départ (dans l’exemple ci-dessous, le solde disponible est de € 14.000 et le clearing est de € 12.000).
| Type de paiement | Nombre | Montant |
|---|---|---|
| Pay.paiement – Solde final du clearing | 1 | € 4.000 |
| iDEAL | 45 | € 4.500 |
| Carte bancaire | 12 | € 3.000 |
| Bancontact | 5 | € 1.500 |
| Virement bancaire | 5 | € 1.000 |
| Pay.paiement – Solde initial du clearing | 1 | - € 2.000 |
| Total | € 12.000 |
3.2 Pourquoi est-ce important ?
Cela permet aux merchants de rapprocher correctement leurs transactions avec le clearing dans lequel le versement réel a été effectué.
Toutes les transactions ayant contribué au solde ont déjà été prises en compte dans le clearing concerné.
Elles ne sont donc pas reprises une seconde fois lors d’un clearing suivant, ce qui éviterait un double comptage.
3.3 Important pour les partenaires
Si vous utilisez dans l’API un montant de versement inférieur au solde comptable actuel, nous corrigerons automatiquement la différence via une paire « solde initial / solde final ».
Ces montants ne sont pas versés et servent uniquement à garantir un reporting et un rapprochement corrects.
4. Imputer des factures sur le solde comptable du submerchant
Pour un démarrage rapide, consultez l’exemple dans le php SDK ou utilisez Alliance::addInvoice.
Documentation complète disponible prochainement