Transfert de Carte

Le transfert de carte permet un achat en un clic en réutilisant le moyen de paiement enregistré du client à partir de sa transaction principale. L'intégration utilise l'API Forward du PSP du partenaire pour transmettre en toute sécurité les détails de la carte au point de terminaison conforme PCI de Rokt, où le paiement est traité avec la marque du catalogue Rokt en tant que MoR.

Le transfert de carte est pris en charge sur web et iOS.

Aperçu de la séquence

1. Le client clique sur "Acheter maintenant" sur le placement Rokt dans la page de confirmation.
2. Rokt appelle l'API du partenaire. Rokt envoie une requête API au backend du partenaire, signalant que le client a initié un achat et que ses détails de paiement enregistrés sont nécessaires.
3. Le partenaire recherche le moyen de paiement en utilisant l'attribut de référence de paiement transmis dans l'appel selectShoppableAds (ou selectPlacements).
4. Le partenaire transfère les détails de la carte. Le partenaire appelle l'API Forward du PSP pour transférer le PAN brut du client, l'adresse de facturation et (si disponible) le CVV au point de terminaison de destination de Rokt.
5. Rokt traite le paiement. Le point de terminaison conforme PCI de Rokt reçoit les détails de la carte, crée un jeton sécurisé non persistant et traite le paiement avec la marque en tant que MoR.
6. Confirmation affichée. Rokt retourne le résultat. Le placement affiche l'état de confirmation.

Attributs requis

Le transfert de carte nécessite les attributs suivants dans votre appel Shoppable Ads. Pour la liste complète, consultez les attributs de placement dans le Guide d'Intégration SDK+.

Web

Attribut	Type	Requis	Description
partner_payment_reference	chaîne	Oui	Identifiant non devinable utilisé pour rechercher le moyen de paiement enregistré du client.
last_4_digits	chaîne	Oui	Les 4 derniers chiffres de la carte utilisée pour la transaction principale. Affichés au client pour confirmation.
payment_type	chaîne	Oui	Moyen de paiement utilisé pour la transaction principale (par exemple, visa, mastercard, amex). Utilisé pour déterminer quelles options de paiement afficher.

iOS

Sur iOS, transmettez les mêmes valeurs en utilisant des clés d'attribut en minuscules (sans underscores) :

Attribut	Type	Requis	Description
partnerpaymentreference	chaîne	Oui	Identifiant non devinable utilisé pour rechercher le moyen de paiement enregistré du client.
last4digits	chaîne	Oui	Les 4 derniers chiffres de la carte utilisée pour la transaction principale.
paymenttype	chaîne	Oui	Moyen de paiement utilisé pour la transaction principale (par exemple, visa, mastercard, amex).

extension de paiement iOS requise

registerPaymentExtension est requis pour lancer tout placement Shoppable Ads sur iOS, y compris les intégrations uniquement de transfert de carte. Vous n'avez pas besoin de configurer Apple Pay si le transfert de carte est votre seul moyen soutenu par Stripe — voir Appendice E : Configurer les paiements Shoppable Ads dans le Guide d'Intégration SDK+ iOS pour la configuration minimale de l'extension.

Le SDK iOS gère le transfert de carte nativement (Rokt-Widget 5.2.0+ / RoktSDKPlus 9.2+). L'API de Partage de Paiement du partenaire ci-dessous est toujours requise pour que Rokt puisse demander les détails de la carte enregistrée à votre backend.

REMARQUE : Si votre plateforme n'a pas de détails d'adresse de livraison disponibles (par exemple, achat de billets ou de biens numériques), transmettez les détails de l'adresse de facturation à la place. Rokt fournira une interface utilisateur pour que le client confirme ou modifie son adresse de livraison avant de finaliser l'achat.

API de partage de paiement

Les partenaires doivent construire et exposer un point de terminaison API côté serveur que Rokt peut appeler pour initier le processus de transfert de paiement.

Exemple de requête

POST /v1/initiate-payment-sharing
Authorization: Bearer <OAUTH_TOKEN>

{
  "customerIdentifiers": {
    "email": "john.smith@example.com"
  },
  "partnerPaymentReference": "ORDER_67890",
  "destination": "COM.ROKT.CATALOG"
}

Champs requis

Champ	Type	Description
partnerPaymentReference	String	La référence de paiement transmise en tant qu'attribut SDK, utilisée pour rechercher la méthode de paiement enregistrée.
destination	String	Type de requête. Utilisez "COM.ROKT.CATALOG" pour les publicités achetables.
customerIdentifiers	Object	Identifiants supplémentaires optionnels (par exemple, customerId) pour une validation de sécurité supplémentaire.

IMPORTANT : Limitez ce point de terminaison API aux adresses IP statiques de Rokt. Rokt fournira une liste d'IPs à mettre sur liste blanche. Utilisez OAuth 2.0 avec des jetons de courte durée pour l'authentification.

Configuration de l'API de transfert

Configurez l'API de transfert de votre PSP pour transférer les données de carte à Rokt :

• Configuration de la destination : Créez une nouvelle destination API de transfert (config) pointant vers le point de terminaison conforme PCI de Rokt. En production, soumettez un fichier de configuration JSON à votre PSP pour examen et approbation. Rokt fournira l'URL de destination et les en-têtes requis.
• Permissions API : Assurez-vous que votre compte PSP a l'accès à l'API de transfert activé. L'utilisation en production est soumise à éligibilité - contactez votre gestionnaire de compte PSP.

Format de réponse

La réponse de l'API partenaire doit inclure le corps complet retourné par l'API de transfert du PSP :

{
  "status": 200,
  "headers": { "Content-Type": "application/json" },
  "body": {
    "body-from-psp": "..."
  },
  "request-time": 150
}