- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Paiements Trustly
Trustly
Trustly est un mode de paiement par virement bancaire. Avec Trustly, les payeurs peuvent effectuer des paiements rapides, simples et sécurisés directement à partir de leurs comptes bancaires sans risque de vol de données ou de fraude. Les payeurs peuvent également effectuer des paiements de commerce électronique et authentifier le paiement via leur interface bancaire en ligne existante.
Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration Trustly.
Conditions préalables
Pour proposer le mode de paiement Trustly via <<paymentGateway>>,
- vous devez être inscrit auprès de votre prestataire de services de paiement avec redirection,
- votre profil de commerçant sur <<paymentGateway>> doit être configuré en utilisant les détails de votre compte auprès de votre prestataire de services de paiement avec redirection, et
- vous devez disposer d'un compte bancaire dans l'une des devises prise en charge enregistré pour votre compte de commerçant chez votre prestataire de services de paiement avec redirection.
Transactions Trustly
Trustly prend en charge les transactions provenant de différents pays avec leurs devises correspondantes.
| Pays | Devise |
|---|---|
| Autriche (AUT) | EUR |
| Allemagne (DEU) | EUR |
| Danemark (DNK) | EUR, DK |
| Estonie (EST) | EUR |
| Espagne (ESP) | EUR |
| Finlande (FIN) | EUR |
| Grande-Bretagne (GBR) | GBP |
| Lituanie (LTU) | EUR |
| Lettonie (LVA) | EUR |
| Pays-Bas (NLD) | EUR |
| Norvège (NOR) | EUR, NOK |
| Portugal (PRT) | EUR |
| Suède (SWE) | EUR, SEK |
Intégration Trustly
L'intégration <<checkout>> vous permet de recueillir des détails de paiement auprès de votre payeur à l'aide d'une interaction hébergée et affichée par <<paymentGateway>>.
À compter de la version 65 de l'API, Trustly est automatiquement disponible comme mode de paiement après votre activation et votre configuration par votre <<paymentServiceProvider>> pour ce mode de paiement.
Pour plus d'informations, voir Intégration des paiements avec redirection via <<checkout>>.
L'intégration <<directPayment>> vous permet de proposer le mode de paiement Trustly sur votre propre page de paiement.
Outre les champs standard requis dans une demande de paiement avec redirection, vous devez renseigner les champs suivants dans la demande Initiate Browser Payment (Lancer un paiement avec redirection) :
Champs communs
sourceOfFunds.type=TrustlybrowserPayment.operation=PAY (Trustly does not support the Authorize operation)customer.account.id=The ID, username, hash, or anything that is used to identify the consumer.customer.email=Email address of a payer.sourceOfFunds.provided.trustly.bankAccountHolder=Name of the bank account holder for the payer's bank account.sourceOfFunds.provided.trustly.bankAccountCountryCode=The country where payers have their bank account. Provide the ISO 3166 alpha-3 country code for this country.
Langue préférée
Vous pouvez définir la langue que vous préférez que Trustly utilise pour les pages affichées au payeur en renseignant le champ browserPayment.preferredLanguage dans la demande Initiate Browser Payment (Lancer un paiement avec redirection). Toutefois, la langue n'est utilisée que si Trustly la prend en charge.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"billing": {
"address": {
"country": "POL"
}
},
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com",
"account": {
"id": "Customer"
}
},
"order": {
"amount": 100,
"currency": "PLN"
},
"sourceOfFunds": {
"type": "TRUSTLY",
"provided": {
"trustly": {
"bankAccountHolder": "Test Tester",
"bankAccountCountryCode": "POL"
}
}
}
}
Comment interpréter le résultat de la transaction
Le tableau ci-dessous illustre les codes de réponse de transaction pour les scénarios possibles auxquels vous pouvez devoir faire face après avoir initié un paiement Trustly.
| Réponse Initiate Browser Payment (Lancer un paiement avec redirection) | Qu'est-ce que cela signifie ? |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigez le payeur en utilisant l'URL indiquée dans la réponse. |
| Réponse Retrieve Transaction/Retrieve Order (Extraire une transaction/Extraire une commande) | Qu'est-ce que cela signifie ? |
response.gatewayCode=APPROVEDresult=SUCCESS |
Le paiement a réussi. |
response.gatewayCode=PENDINGresult=PENDING |
<<paymentGateway>> attend une notification de l'acquéreur à propos du résultat du paiement. Réessayez la transaction RETRIEVE_TRANSACTION ou surveillez les notifications de <<paymentGateway>>. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Le payeur a annulé l'interaction pour ce paiement. Proposez au payeur d'essayer un autre mode de paiement. |
response.gatewayCode=DECLINED ou ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer un autre mode de paiement. En cas d'une erreur ACQUIRER_SYSTEM_ERROR, vous pouvez vouloir demander à l'acquéreur la raison de l'échec du paiement, ou vous pouvez réessayer la transaction RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Traitez cela comme un paiement refusé. <<paymentGateway>> vérifiera que la transaction a échoué ou l'annulera. |
Remboursements
Vous pouvez rembourser les paiements Trustly en plusieurs paiements échelonnés ou en totalité. Assurez-vous que les remboursements sont configurés pour vous sur <<paymentGateway>> et sur votre compte de commerçant au niveau de votre prestataire de services de paiement avec redirection.
Test de votre intégration
<<paymentGateway>> propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration Trustly.