Autres moyens de paiementVersion bêta publique

Pour accepter des moyens de paiement autres que les cartes via l’interface de QR code, créez un PaymentIntent et incluez vos types de moyens de paiement préférés dans le paramètre payment_method_types.

• Pour présenter à votre client toutes les options de moyens de paiement dans le tunnel de paiement, combinez card_present avec des types de moyens de paiement sans carte bancaire. Nous recommandons d’activer cela si vous opérez dans un environnement fortement hors ligne car seules les cartes bancaires sont prises en charge en mode hors ligne.
• Si vous ne souhaitez pas accepter de cartes, ne prenez en charge que les types de moyen de paiement sans carte bancaire.
• Si vous savez vers quel moyen de paiement vous souhaitez diriger votre client vers le règlement, sélectionnez un seul type de moyen de paiement.

Type de capture

De nombreux moyens de paiement ne prennent pas en charge la capture manuelle. Créez votre PaymentIntent avec le paramètre capture_method défini sur automatic pour prendre en charge le plus grand nombre de moyens de paiement possible. Pour prendre en charge la capture manuelle des paiements par carte bancaire tout en acceptant les moyens de paiement qui requièrent une capture automatique, attribuez la valeur manual à l’attribut capture_method de l’élément imbriqué payment_method_options.card_present.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d "payment_method_types[]"=wechat_pay \
  -d capture_method=automatic \
  -d "payment_method_options[card_present][capture_method]"=manual

Contrairement aux paiements par carte, le traitement des paiements par QR code se fait de manière asynchrone. Lorsque vous traitez un PaymentIntent avec un moyen de paiement par QR code, Stripe génère un QR code propre à ce paiement. Après le traitement du paiement, le lecteur affiche le QR code pour que le client puisse le scanner avec son appareil mobile. Le client effectue alors le paiement sur son appareil, puis le lecteur s’actualise pour refléter le paiement effectué.

Les paiements par QR code prennent en charge le traitement immédiat des paiements et le flux en deux étapes avec collecte et confirmation distinctes.

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent=pi_xxx \
  --data-urlencode "process_config[return_url]"="https://my.store.com/payment-completed"

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

{
  "id": "tmr_xxx",
  "object": "terminal.reader",
  ...
  "status": "online",
  "action": {
    "type": "process_payment_intent",
    "process_payment_intent": {
      "payment_intent": "pi_xxx"
    },
    "status": "in_progress",
    "failure_code": null,
    "failure_message": null
  }
}

Libérez le lecteur pour accepter un autre paiement

Il peut falloir plusieurs minutes à un client pour finaliser le paiement sur son appareil. Au lieu d’attendre que le lecteur reflète le résultat du paiement finalisé, vous pouvez libérer le lecteur pour qu’il accepte un paiement pour un autre client.

Après que le client a scanné le QR code et est passé à son appareil pour finaliser le paiement, utilisez l’endpoint cancel_action pour réinitialiser le lecteur.

curl -X POST https://api.stripe.com/v1/terminal/readers/tmr_xxx/cancel_action \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Après avoir annulé l’action du lecteur pour confirmertraiter le paiement, l’intention de paiement reste dans l’état requires_action, permettant au client de compléter le paiement. Utilisez les webhooks payment_intent.succeeded etpayment_intent.payment_failed pour rapprocher le résultat du paiement complété. Apprenez comment surveiller un PaymentIntent avec des webhooks.