Code QR et paiement instantané

Dans le cadre du processus QR Code & Instant Payment, Yuno présente un code QR unique qui permet à la fois de facturer immédiatement le client et de l'inscrire pour tous les paiements récurrents futurs en une seule étape fluide. Lorsque le client scanne le QR, son application bancaire traite le premier versement et obtient simultanément son consentement pour les prélèvements automatiques ultérieurs, éliminant ainsi tout besoin d'approbation supplémentaire ou de saisie manuelle.

Après le scan initial et le paiement, chaque demande ultérieure est envoyée par le commerçant via Yuno et validée automatiquement par la banque du client par rapport au consentement initial, garantissant ainsi des transferts rapides et fiables sans autre interaction de la part du client. Ce flux optimise la conversion et simplifie la gestion des abonnements en combinant l'inscription et le paiement en une seule action utilisateur.

Étape 1 : Premier paiement et création de l'abonnement

Pour lancer le flux, vous devez commencer par une norme Paiement Pix qui configure également l'abonnement. Cela génère un code QR ou un écran de redirection permettant au client d'autoriser la récurrence. Une fois le paiement effectué, l'abonnement est créé et un subscription_id est renvoyé.

Vous pouvez définir la fréquence, la fenêtre de disponibilité et le type de montant (fixe ou variable) dans le cadre de la charge utile de l'abonnement.

Champs pour les abonnementsDescription
FréquenceDéfinissez la fréquence à laquelle les frais d'abonnement seront facturés, que ce soit quotidiennement, hebdomadairement ou mensuellement, en précisant le montant à facturer pour le prochain cycle de facturation.
DisponibilitéLes dates de début et de fin de l'abonnement.
MontantDéfinissez la valeur que vous utiliserez pour les futurs paiements de l'abonnement. Cela peut être FIXED avec une valeur minimale définie, ou VARIABLE sans montant défini pour les paiements futurs.

Comme mentionné précédemment, gardez à l'esprit que les informations définies lors de la création de l'abonnement limiteront les dates et les montants pouvant être utilisés pour les paiements futurs.

{
  "amount": {
    "value": "100",
    "currency": "BRL"
  },
	"payment_method": {
        "type": "PIX_AUTOMATIC"
	},
	"subscription": {
    "frequency": {
      "type": "MONTH",
      "value": 1
    },
    "availability": {
      "start_at": "2025-05-23T20:17:30.277678Z",
      "finish_at": "2027-05-23T20:17:30.277678Z"
    },
    "amount": {
      "value": "100",
      "currency": "BRL",
      "type": "FIXED" // or "VARIABLE"
    }
  }

Une fois le paiement initial confirmé, le client dispose d'un abonnement actif et vous pouvez commencer à planifier les futurs prélèvements.

Étape 2 : Paiements futurs

Comme défini par la banque centrale, les paiements doivent être créés au plus tard 2 jours avant la date de facturation prévue et au moins 10 jours après la création de l'abonnement. Utilisez le subscription_id pour identifier la récurrence dans la création du paiement.

Champs pour les paiements futurs
subscription_idIdentifiant de l'abonnement obtenu lors de la première étape.
date_de_facturationEn spécifiant l'objet billing_date, le commerçant peut définir la logique qui détermine la date exacte de facturation de l'abonnement.
"workflow": "DIRECT",
"amount": {
  "value": "100",
  "currency": "BRL"
},
"payment_method": {
  "type": "PIX_AUTOMATIC",
},
"subscription": {
  "id": "cab9f0fe-2428-419b-8f9d-4b5efee8c1c8",
  "billing_date": {
    "type": "DAY",
    "day": 14
  }
}

Si un paiement récurrent échoue, il peut être réessayé à l'aide d'une nouvelle demande de paiement. Les nouvelles tentatives doivent avoir lieu dans les 7 jours suivant la date de facturation initiale et sont limitées à 3 tentatives par cycle.