- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Paiements eNETS
eNETS
eNETS est un système de paiement pour commerce électronique utilisé à Singapour qui permet aux payeurs d'effectuer des achats en utilisant les virements en ligne directs à partir de leur compte bancaire. Les payeurs sont redirigés sur le site Web en ligne de leur banque où ils peuvent initier un virement en ligne direct.
eNETS est un mode de paiement avec redirection prise en charge sur Payment Gateway. Cette page explique les détails de l'intégration spécifique à eNETS. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration eNETS.
Les paiements avec redirection eNETS ne sont pris en charge que pour les transactions dans la devise SGD. Les paiements avec redirection eNETS sont pris en charge si vous êtes en dehors de Singapour et pour les payeurs situés à Singapour.
Conditions préalables
Pour proposer eNETS comme mode de paiement via Payment Gateway :
- vous devez être inscrit auprès de votre prestataire de services de paiement avec redirection,
- votre profil de commerçant sur la passerelle doit être configuré en utilisant les détails de votre compte auprès de votre prestataire de services de paiement avec redirection,
- 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.
Intégration eNETS
Avec les intégrations à compter de la version 51 de Hosted Checkout, eNETS est automatiquement disponible pour vos payeurs lorsque vous êtes activé et configuré pour cela par votre your payment service provider.
Pour plus d'informations, voir Intégration des paiements avec redirection via Hosted Checkout.
L'intégration Direct API vous permet de proposer le mode de paiement eNETS sur votre propre page de paiement.
En plus des 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) :
sourceOfFunds.type=ENETSbrowserPayment.operation=PAY(l'opération Authorize (Autoriser) n'est pas prise en charge par ENETS)customer.email: Adresse e-mail du payeur.customer.phone: Numéro de téléphone du payeur au format ITU-T E123, par exemple +1 607 1234 456sourceOfFunds.provided.enets.bankAccountHolder: Nom du titulaire du compte bancaire pour le compte bancaire du payeur.
Langue préférée
Vous pouvez définir la langue que vous préférez que eNETS 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 eNETS la prend en charge.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"customer": {
"email": "john.smith@example.com",
"phone": "01234567890"
},
"order": {
"amount": "10.00",
"currency": "SGD"
},
"sourceOfFunds": {
"type": "ENETS",
"provided": {
"enets": {
"bankAccountHolder": "John Smith"
}
}
}
}
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 eNETS.
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=SUCCESSsourceOfFunds.provided.enets.bankAccountHolder
|
Le paiement a réussi. |
response.gatewayCode=PENDINGresult=PENDING |
Payment Gateway attend une notification de l'acquéreur à propos du résultat du paiement. Réessayez la transaction RETRIEVE_TRANSACTION ou surveillez les notifications de Payment Gateway. |
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 or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer un autre mode de paiement. Dans le 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é. Payment Gateway vérifiera que la transaction a échoué ou l'annulera. |
Test de votre intégration
Payment Gateway propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration eNETS.