Le lundi 26 avril 2021, nous avons ajouté un nouveau champ à l’API Get Account afin de répondre à une exigence d’intégration pour certains clients et leurs clients finaux. Utilisez cette FAQ pour savoir ce que cela signifie pour vous et comment utiliser le nouveau champ.
Est-ce que cela s’applique à moi ?
Si vous ou vos clients finaux concluez un contrat avec notre entité située dans l’UE (Currencycloud BV) par le biais de notre modèle Outsourced KYC Global Business Introducer, ce nouveau champ vous concerne.
Qu’est-ce qui change ?
Nous ajoutons un nouveau champ « bank_account_verified » (compte bancaire vérifié) à l’API Get Account afin de répondre à une exigence relative aux virements tests (Penny Test) lors de l’intégration. Vous pouvez en savoir plus sur les virements tests ci-dessous. En ajoutant ce nouveau champ à notre API, nous vous donnons la possibilité de voir rapidement et facilement si un client final a réussi le test. Un compte sera généralement activé 1 à 2 heures après la réussite d’un virement test.
Grâce à ce champ supplémentaire, vous serez en mesure de refléter le statut du virement test de votre client final dans votre propre interface. Pour simplifier encore davantage les choses, nous avons également créé de nouvelles notifications qui vous informent, vous ou votre client final, dès que ce dernier a réussi le test, ce qui vous évite de devoir aller vérifier.
Que sont les virements tests et comment fonctionnent-ils ?
Un virement test, parfois appelé Penny Test, est utilisé pour vérifier l’authenticité du compte bancaire d’un utilisateur et confirmer que le compte bancaire appartient bien à l’utilisateur. Pour réaliser ce test, un utilisateur dépose un petit montant (généralement un penny, d’où le nom !) qui renvoie les coordonnées bancaires validées ainsi que le nom du bénéficiaire.
Comme il s’agit désormais d’une exigence d’intégration imposée par le régulateur néerlandais, tous les clients finaux situés dans l’UE devront à présent réussir ce test avant que nous puissions activer complètement leur compte.
Pour réussir le virement test et terminer l’intégration, vos clients finaux doivent déposer au moins 0,01 € sur leur compte Currencycloud à partir d’un compte bancaire au nom du titulaire du compte qui est situé dans l’Espace économique européen (EEE).
Que dois-je faire ?
Pour recevoir des notifications automatiques lorsque vos clients finaux réussissent leur virement test, vous devez activer notre nouveau Webhook et nos notifications par e-mail. Veuillez contacter votre Customer Success Manager pour discuter des options disponibles.
Vous pouvez également demander le statut du virement test via l’API. Maintenant que le nouveau champ est en ligne, vous pouvez l’ajouter à votre interface utilisateur afin de visualiser à quel moment votre client final a réussi le virement test. Pour ce faire, vous devez commencer à analyser ce champ à partir de la réponse de l’API Get Account. Vous trouverez ci-dessous un exemple de réponse de l’API, avec le nouveau champ, « bank_account_verified », mis en évidence.
{
"id": "cf28b2d8-5afa-4d7f-9a26-7b45bf616a11",
"account_name": "Mon exemple de compte",
"brand": "currencycloud",
"your_reference": null,
"status": "enabled",
"street": "Mon exemple de rue",
"city": "Mon exemple de ville",
"state_or_province": null,
"country": "GB",
"postal_code": "Exemple de code",
"spread_table": "fxcg_rfx_default",
"legal_entity_type": "company",
"created_at": "2018-04-26T15:05:01.000Z",
"updated_at": "2020-09-07T11:56:59.000Z",
"identification_type": null,
"identification_value": null,
"short_reference": "180426-00018",
"api_trading": true,
"online_trading": true,
"phone_trading": true,
"process_third_party_funds": false,
"settlement_type": "net",
"agent_or_reliance": false,
"terms_and_conditions_accepted": null
"bank_account_verified": true
}
Depuis quand les changements sont-ils effectifs ?
Le nouveau champ a été ajouté à l’API et peut être utilisé depuis le lundi 26 avril 2021. Le Webhook et les notifications par e-mail sont également disponibles depuis cette date.