UPI - UnionPay International
Introduction
UPI - UnionPay International est une filiale de China UnionPay.
Elle entretient des partenariats avec plus de 2400 institutions dans le monde, permettant l'acceptation des cartes dans 180 pays et régions avec une émission dans 70 pays et régions.
UnionPay International offre des services de paiement transfrontalier de haute qualité, rentables et sécurisés à la plus grande base de titulaires de cartes au monde.
Pays & devises
Pays pris en charge
-
Îles Åland
-
Albanie
-
Algérie
-
Samoa américaines
-
Andorre
-
Angola
-
Anguilla
-
Antarctique
-
Antigua-et-Barbuda
-
Argentine
-
Arménie
-
Aruba
Devises prises en charge
- Australian dollar (AUD)
- Canadian dollar (CAD)
- Czech koruna (CZK)
- Danish krone (DKK)
- Euro (EUR)
- Hong Kong dollar (HKD)
- Hungarian forint (HUF)
- Japanese yen (JPY)
- New Zealand dollar (NZD)
- Norwegian krone (NOK)
- Polish zloty (PLN)
- Pound sterling (GBP)
Intégration
- Lors de l'utilisation de la fonctionnalité de routage carte Multi-Network, vous devez en informer vos clients en conséquence. En fonction de la méthode d'intégration, des différences s'appliquent. Lisez nos chapitres dédiés ci-dessous pour obtenir des instructions sur vos obligations et options. Trouvez des informations détaillées dans nos guides dédiés sur la détection/présélection de marque et le classement de marque.
- eftpos ne prend en charge que les opérations de Direct Sale. Par conséquent, nous recommandons fortement d'envoyer cardPaymentMethodSpecificInput.authorizationMode=SALE dans toutes vos requêtes CreateHostedCheckout/CreatePayment. Notre plateforme convertira "FINAL_AUTHORIZATION" en "SALE" pour garantir que les cartes multi-réseaux soient traitées comme des transactions eftpos.
Nous proposons ces méthodes de paiement pour les méthodes d'intégration suivants. Découvrez leurs différences dans nos guides dédiés :
Veuillez trouver une vue d'ensemble dans le chapitre "Cinématique".
Selon votre méthode d'intégration, des différences s'appliquent :
Hosted Checkout Page
Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :
{
"hostedCheckoutSpecificInput": {
"locale": "en_GB",
"returnUrl": "https://yourReturnUrl.com",
"cardPaymentMethodSpecificInput": {
"groupCards": true,
"clickToPay": false
},
"paymentProductFilters": {
"restrictTo": {
"groups": [
"cards"
]
}
}
},
"order": {
"amountOfMoney": {
"amount": 100,
"currencyCode": "AUD"
}
}
}
| Propriétés | Remarques |
|---|---|
|
hostedCheckoutSpecificInput.returnURL |
L'URL vers laquelle nous redirigeons vos clients une fois le paiement finalisé. |
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
To allow our platform to route a Multi-Network Card transaction via eftpos, remove productpaymentId and add property groupCards=true in your request. Find detailed information in our dedicated guides about brand detection/preselection and brand ordering.
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Hosted Tokenization Page
Ajoutez les propriétés suivantes à une requête standard CreatePayment (y compris les propriétés 3-D Secure) après avoir tokenisé la carte :
{
"hostedTokenizationId":"hostedTokenizationId",
"order":{
"amountOfMoney":{
"amount":1000,
"currencyCode":"EUR"
},
"customer":{
"account":{
"authentication":{
"method":"guest",
"utcTimestamp":"202309261631"
},
"changeDate":"20200101",
"changedDuringCheckout":true,
"createDate":"20100101",
"hadSuspiciousActivity":false,
"passwordChangeDate":"20200101",
"passwordChangedDuringCheckout":false,
"paymentAccountOnFile":{
"createDate":"20100101",
"numberOfCardOnFileCreationAttemptsLast24Hours":1
},
"paymentActivity":{
"numberOfPaymentAttemptsLast24Hours":1,
"numberOfPaymentAttemptsLastYear":0,
"numberOfPurchasesLast6Months":0
}
},
"accountType":"existing",
"billingAddress":{
"countryCode":"BE",
"city":"Brussels",
"houseNumber":"3",
"state":"Flemish Brabant",
"street":"Da Vincilaan",
"zip":"1930",
"additionalInfo":"floor 9"
},
"contactDetails":{
"emailAddress":"wile.e.coyote@acmelabs.com",
"phoneNumber":"+321234567890"
},
"device":{
"acceptHeader":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,/;q=0.8",
"browserData":{
"colorDepth":99,
"javaEnabled":true,
"javaScriptEnabled":true,
"screenHeight":"768",
"screenWidth":"1024"
},
"ipAddress":"123.123.123.123",
"locale":"en_GB",
"userAgent":"Mozilla/5.0(WindowsNT10.0;Win64;x64)AppleWebKit/537.36(KHTML,likeGecko)Chrome/75.0.3770.142Safari/537.36",
"timezoneOffsetUtcMinutes":"-180"
}
}
}
}
| Propriétés | Remarques |
|---|---|
|
hostedTokenizationId |
La carte tokenisée renvoyée via le méthode d'intégration Hosted Tokenization Page. Consultez notre guide dédié pour en savoir plus. |
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
|
order.customer.account order.customer.accountType |
Propriétés optionnelles pour 3-D Secure. Consultez notre guide dédié pour en savoir plus. |
|
order.customer.billingaddress |
Propriétés recommandées pour 3-D Secure. Consultez notre guide dédié pour en savoir plus. |
|
order.customer.device |
Propriétés obligatoires pour 3-D Secure afin de respecter la SCA / authentification forte. Consultez notre guide dédié pour en savoir plus. |
Trouvez des informations détaillées sur cet objet et ses propriétés dans notre API HostedTokenizationAPI/ CreatePaymentAPI.
Add paymentProductFilters.exclude to your request to preselect the available brands in the Hosted Tokenization Page iframe, enabling/disabling the Multi-Network Card transaction respectively. To allow our platform to route a Multi-Network Card transaction via eftpos, remove productpaymentId and add property groupCards=true in your request. Find detailed information in our dedicated guides about brand detection/preselection and brand ordering.
Server-to-server
Ajoutez les propriétés suivantes à une requête standard CreatePayment (y compris les propriétés 3-D Secure obligatoires) :
{
"CardPaymentMethodSpecificInput": {
"PaymentProductId": XXX,
"SkipAuthentication": false,
"Card": {
"CardholderName": "John Doe",
"CardNumber": "0000000000000000",
"Cvv": 123,
"ExpiryDate": 1236
},
"ThreeDSecure": {
"RedirectionData": {
"ReturnUrl": "https://yourRedirectionUrl.com"
}
}
},
"Order": {
"AmountOfMoney": {
"Amount": 100,
"CurrencyCode": "AUD"
},
"Customer": {
"Device": {
"AcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3",
"Locale": "en_EN",
"TimezoneOffsetUtcMinutes": -180,
"UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.142 Safari/537.36",
"Browserdata": {
"ColorDepth": 24,
"JavaScriptEnabled": false,
"ScreenHeight": "1080",
"ScreenWidth": "1920"
}
}
}
}
}
| Propriétés | Remarques |
|---|---|
|
cardPaymentMethodSpecificInput.paymentProductId cardPaymentMethodSpecificInput.card cardPaymentMethodSpecificInput.ThreeDSecure |
paymentProductId : L'identifiant numérique du mode de paiement sur notre plateforme. Trouvez cet id dans le chapitre "Aperçu".
returnURL : L'URL vers laquelle nous redirigeons vos clients une fois le paiement finalisé. |
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
|
customer.device |
Propriétés minimales pour se conformer au SCA pour l'authentification 3-D Secure. Consultez notre guide dédié pour apprendre comment demander correctement le 3-D Secure et consultez notre référence API pour plus d'informations sur les propriétés. |
Trouvez des informations détaillées sur cet objet et ses propriétés dans notre CreatePaymentAPI.
Cinématique
Nous proposons cette méthode de paiement pour tous nos méthodes d'intégration. Quel que soit le mode que vous choisissez, le processus suit quelques étapes de base comme décrit ci-dessous. Découvrez dans nos guides dédiés les spéciticités de chacune :
- Vos clients finalisent une commande dans votre boutique et sélectionnent cette méthode de paiement.
- Vous envoyez une requête CreateHostedCheckout/CreatePayment à notre plateforme. Selon votre méthode d'intégration, des différences s'appliquent. Consultez le chapitre “Intégration” pour trouver des exemples pour chaque mode.
- Notre plateforme vous envoie une réponse avec des instructions pour les prochaines étapes du processus.
- Vos clients fournissent leur numéro de carte de crédit et sont redirigés vers leur émetteur pour une authentification 3-D Secure.
- Notre système reçoit le résultat de l'authentification 3-D de l'émetteur.
- Nous traitons la transaction et recevons le résultat de l'acquéreur.
- Nous redirigeons votre client vers votre returnUrl .
- Vous demandez le résultat de la transaction de notre plateforme via GetPaymentDetails /GetHostedCheckout ou recevez le résultat via des webhooks.
- Si la transaction a réussi, vous pouvez livrer les marchandises/services.
Test
Consultez nos Cas de test pour des données de test et des instructions détaillées.
- Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.
- Les données dans notre chapitre Cas de test fonctionnent UNIQUEMENT pour les demandes de paiement dans notre environnement de test. Utiliser ces données dans notre environnement de production entraînera des résultats de test indésirables.