Accepter des paiements avec Kakao Pay en Corée du Sud

Découvrez comment accepter des paiements Kakao Pay.

Intégrer Kakao Pay permet aux clients basés en Corée du Sud de payer en utilisant ce moyen de paiement local très répandu.

Lorsqu’un client effectue un paiement, nous le redirigeons vers notre prestataire de services de paiement local pour qu’il l’authentifie et l’autorise. Une fois que le client a autorisé le paiement, Stripe le redirige vers votre site.

Utilisez l’API Payment Intents pour accepter les paiements de clients sud-coréens utilisant des cartes et des moyens de paiement locaux.

Configurer Stripe
Côté serveur

Pour commencer, vous devez créer un compte Stripe. S’inscrire.

Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :

Créer un PaymentIntent
Côté serveur

Un PaymentIntent est un objet qui représente votre intention d’encaisser le paiement d’un client et qui suit le processus de paiement. Pour créer un PaymentIntent qui accepte un paiement à l’aide de kakao_pay, indiquez le montant à encaisser, krw comme devise et kakao_pay dans la liste payment_method_types. Si vous conservez une liste des types de moyens de paiement que vous transmettez lors de la création d’un PaymentIntent, ajoutez-y kakao_pay.

En outre, vous devez indiquer l’adresse e-mail du client.

Récupérer la clé secrète du client

Le PaymentIntent contient une clé secrète à utiliser côté client pour finaliser le processus de paiement en toute sécurité. Vous pouvez adopter différentes approches pour transmettre cette clé secrète côté client.

Récupérez la clé secrète du client à partir d’un endpoint sur votre serveur, à l’aide de la fonction fetch du navigateur. Cette approche est recommandée si votre côté client est une application d’une seule page, en particulier si elle repose sur un framework front-end moderne tel que React. Créez l’endpoint de serveur qui gère la clé secrète du client :

Récupérez ensuite la clé secrète du client à l’aide JavaScript côté client :

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

Assurez-vous que vos clients comprennent les conditions d’utilisation
Côté client

Le prestataire partenaire de Stripe exige que les clients soient informés de l’identité du prestataire et comprennent ses conditions d’utilisation. Vous devez inclure la langue et le lien suivants dans votre page de paiement :

Remarque

Une fois l’opération validée, nous vous redirigeons vers les étapes suivantes. Cette transaction est traitée par NICEPAY, conformément à ses conditions d’utilisation.

Rediriger vers le sous-traitant local
Côté client

Lorsqu’un client clique pour payer avec Kakao Pay, utilisez Stripe.js pour soumettre le paiement à Stripe. Stripe.js est la bibliothèque JavaScript de base pour créer les tunnels de paiement : elle gère automatiquement les opérations complexes telles que la redirection décrite ci-dessous, et facilite l’extension de votre intégration à d’autres moyens de paiement. Incluez le script Stripe.js sur votre page de paiement en l’ajoutant à la section head de votre fichier HTML.

checkout.html
<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/v3/"></script>
</head>

Créez une instance de Stripe.js avec le code JavaScript suivant sur votre page de paiement.

client.js
// Set your publishable key. Remember to change this to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx'
);

Utilisez la clé secrète du client du PaymentIntent et appelez stripe.confirmPayment pour gérer la redirection vers la page de paiement du prestataire de services de paiement local. Sur cette page, le client sélectionne son émetteur et autorise le paiement. Ajoutez un return_url pour indiquer où Stripe redirige le client une fois qu’il a effectué le paiement.

client.js
const form = document.getElementById('payment-form');

form.addEventListener('submit', async function(event) {
  event.preventDefault();

  // Set the clientSecret of the PaymentIntent
  const { error } = await stripe.confirmPayment({
    clientSecret: clientSecret,
    confirmParams: {
      payment_method_data: {
        type: 'kakao_pay',
      },
      // Return URL where the customer should be redirected after the authorization
      return_url: `${window.location.href}`,
    },
  });

  if (error) {
    // Inform the customer that there was an error.
    const errorElement = document.getElementById('error-message');
    errorElement.textContent = result.error.message;
  }
});

Le return_url correspond à une page de votre site Web qui affiche le résultat du paiement. Vous pouvez déterminer ce qu’il faut afficher en vérifiant l’état du PaymentIntent. Pour vérifier l’état, la redirection Stripe vers le return_url inclut les paramètres de requête d’URL suivants. Vous pouvez également ajouter vos propres paramètres de requête au return_url. Ces paramètres persistent tout au long du processus de redirection.

Paramètre	Description
`payment_intent`	L’identifiant unique du `PaymentIntent`.
`payment_intent_client_secret`	La clé secrète du client de l’objet `PaymentIntent`.

Test integration with Kakao Pay

Testez votre intégration avec Kakao Pay en affichant la page de redirection à l’aide de vos clés API de test. Vous pouvez tester le cas de paiement réussi en authentifiant le paiement sur la page de redirection. Le PaymentIntent passe de requires_action à succeeded. Pour tester le cas où le client ne parvient pas à s’authentifier, utilisez vos clés API de test et consultez la page de redirection. Sur la page de redirection, cliquez sur Faire échouer le paiement test. Le PaymentIntent passe de requires_action à requires_payment_method.

Accepter des paiements avec Kakao Pay en Corée du Sud

Découvrez comment accepter des paiements Kakao Pay.

Configurer StripeCôté serveur

Créer un PaymentIntentCôté serveur