Accueil
Apple
Apple Pay
Documentation Technique : Apple Pay Standard via Cybersource

Documentation Technique : Apple Pay Standard via Cybersource

Optimisez l’intégration d’Apple Pay avec Cybersource (Simple Order API). Ce guide technique couvre le décryptage des données, l’autorisation et la capture des transactions pour iOS et le Web. Retrouvez les codes d’erreur et les exemples XML. Le manuel complet est disponible en téléchargement gratuit ci-dessous.

Guide d'intégration Apple Pay Standard

Apple Pay Standard : Guide d’intégration Simple Order API

L’intégration d’Apple Pay via la plateforme Cybersource permet aux commerçants de proposer un mode de paiement sécurisé et fluide dans leurs applications iOS ou sur le Web. Ce document technique détaille les procédures d’autorisation, de capture et de gestion des transactions en s’appuyant sur l’API Simple Order de Cybersource.

Méthodes de décryptage et intégration

Le traitement d’un paiement Apple Pay génère un payload chiffré contenant les données sensibles de la carte. Deux approches sont possibles pour traiter ces informations :

  • Décryptage Cybersource : Cybersource gère la génération des clés et le décryptage. Cette méthode est recommandée car elle limite l’exposition de votre système aux données de paiement sensibles.

  • Décryptage Marchand : Vous gérez vous-même les clés de chiffrement et le décryptage du payload Apple Pay avant d’envoyer les données décodées à Cybersource.

Configuration technique

Avant de lancer des transactions réelles, plusieurs étapes de configuration sont indispensables dans le Business Center de Cybersource :

  1. Génération d’un CSR (Certificate Signing Request) : Obligatoire pour le décryptage Cybersource afin de créer le certificat de paiement Apple.

  2. Configuration du Merchant ID : Liaison de votre identifiant marchand Apple dans le panneau de configuration des paiements digitaux.

  3. Tests en Sandbox : Utilisation impérative des comptes de test Apple Sandbox avant de passer en production.

Gestion des services de transaction

Le cycle de vie d’un paiement Apple Pay repose sur trois services principaux :

  • Autorisation (ccAuthService) : Vérifie la validité de la carte et bloque les fonds. Le champ paymentSolution doit être défini sur 001 pour Apple Pay.

  • Capture (ccCaptureService) : Confirme le transfert effectif des fonds. Ce service nécessite l’ID de requête (requestID) généré lors de l’autorisation initiale.

  • Reversement (ccAuthReversalService) : Permet de libérer les fonds retenus sur la carte du client en cas d’annulation de la commande avant la capture.

Résolution des problèmes et pannes fréquentes

Symptôme / Besoin Solution Technique
Erreur de décryptage Vérifiez que le CSR utilisé en production est bien celui généré depuis votre compte de production Cybersource, et non le compte de test.
Transaction refusée (Reason Code 102) Des champs obligatoires sont manquants. Vérifiez les données de facturation (billTo) et l’encodage Base64 du champ encryptedPayment_data.
Échec des tokens réseau Apple Pay repose sur des tokens de réseau de paiement. Assurez-vous que votre processeur (ex: Chase Paymentech) supporte nativement ces jetons.
Annulation de transaction Utilisez toujours l’ID de requête original pour effectuer un ccAuthReversalService afin de libérer immédiatement le plafond bancaire du client.

Téléchargement de la notice Apple Pay Standard

Pour obtenir l’intégralité des spécifications techniques, les schémas de flux détaillés et les listes complètes des champs de l’API Simple Order, vous pouvez consulter la documentation officielle. Ce document est indispensable pour sécuriser vos environnements de test et réussir le passage en production de votre solution de paiement.

Cliquez sur le lien ci-dessous pour télécharger la notice Apple Pay Standard

Télécharger le manuel PDF