Paiements Konbini

Konbini est un moyen de paiement à usage unique qui nécessite que le client effectue quelques actions supplémentaires pour réaliser son paiement. Les clients doivent fournir un code de paiement, un numéro de confirmation et payer en espèces dans un commerce de proximité japonais. Stripe vous enverra une notification une fois le paiement terminé.

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "mode"="payment" \
  -d "payment_method_types[]"="card" \
  -d "payment_method_types[]"="konbini" \
  -d "payment_method_options[konbini][expires_after_days]"=3 \
  -d "line_items[0][price_data][currency]"="jpy" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"="Tシャツ" \
  -d "line_items[0][quantity]"=1 \
  -d "success_url"="https://example.com/success" \
  -d "cancel_url"="https://example.com/cancel"

Expiration et annulation

Une fois la date définie par la valeur expires_at dans next_action.konbini_display_details, le client ne peut plus initier le processus de paiement d’un paiement Konbini en attente dans un kiosque de supérette. Cependant, si un reçu de paiement valide est émis avant l’échéance, il pourra finaliser le paiement à la caisse après la date expires_at.

Dans ce cas, il existe une marge de manœuvre pour éviter des échecs de paiement prématurés. L’état du PaymentIntent passe à requires_payment_method. Vous pouvez alors annuler ou confirmer le PaymentIntent avec un autre moyen de paiement.

Un paiement Konbini en attente peut également être annulé une fois confirmé, avant même la date spécifiée par next_action.konbini_display_details.expires_at. De la même manière, la mise à jour du PaymentIntent ou sa confirmation avec un autre moyen de paiement annulera de manière implicite le paiement Konbini existant.

Si le client effectue actuellement le paiement Konbini dans un commerce de proximité, la requête d’annulation échouera. L’annulation peut à nouveau être envisagée si le client abandonne la tentative de paiement et une fois que le bordereau de paiement a expiré.

Veuillez noter que les problèmes de disponibilité temporaires des moyens de paiement impactent également les demandes d’annulation (explicites comme implicites).

Remboursements

Il est possible de rembourser les paiements Konbini via le Dashboard ou l’API.

Pour exécuter un remboursement et l’envoyer directement sur le compte bancaire du client, votre client doit fournir les coordonnées bancaires du compte sur lequel il souhaite recevoir les fonds. Stripe contacte le client à l’adresse e-mail indiquée dans les informations de facturation et lui demande ces informations. Une fois les coordonnées bancaires reçues, nous procédons automatiquement au remboursement.

L’état du remboursement évolue comme suit :

Si la banque du client ne parvient pas à mener à bien le transfert, les fonds sont reversés à Stripe et le remboursement bascule sur l’état requires_action. Cette situation se produit si le nom du titulaire du compte ne correspond pas aux données que la banque bénéficiaire possède dans ses archives, ou si le numéro de compte bancaire fourni contient une faute de frappe. Dans ces cas-là, Stripe envoie un e-mail au client pour l’informer de l’échec de l’opération et lui demande de soumettre à nouveau ses coordonnées bancaires.

Si votre client ne fournit pas ses coordonnées bancaires sous 45 jours, l’état du remboursement passe à failed et nous envoyons l’événement refund.failed. Cela signifie que Stripe n’est pas en mesure de procéder au remboursement et que vous devez restituer les fonds à votre client en dehors de Stripe.

Le champ instructions_email du remboursement correspond à l’adresse e-mail à laquelle le remboursement a été envoyé. En attente de la réponse du client, vous pouvez retrouver les informations relatives à la date et l’adresse d’envoi de l’e-mail sous le champ next_action.display_details.email_sent du remboursement.

Chaque remboursement (y compris les remboursements partiels) peut entraîner des frais. Veuillez consulter votre contact chez Stripe pour en savoir plus à ce sujet.

Tester les remboursements

Pour tester le comportement de remboursement en mode test, utilisez les comptes bancaires de test suivants sur la page de collecte des coordonnées bancaires, dont le lien figure dans l’e-mail envoyé au client. Aucunes autres coordonnées bancaires ne seront acceptées.

Tester l’expiration des remboursements

Vous pouvez simuler l’expiration d’un remboursement en mode test en effectuant un appel à l’API.

curl https://api.stripe.com/v1/test_helpers/refunds/{{REFUND_ID}}/expire \
  -X POST \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: