Lignes, taxes et détails de commande

Lors de la création d'une session de paiement, vous pouvez transmettre tous les détails. Genius Checkout les utilise à quatre endroits :

1. La page de paiement (pour que le client voie ce qu'il paie)
2. La page de succès et le reçu téléchargeable
3. La passerelle de paiement (champ PowerTranz TaxAmount, etc.)
4. Les charges utiles webhook (pour que votre backend puisse joindre par metadata.order_id, etc.)

Exemple

{
  "line_items": [
    { "name": "Island Rum Cake", "quantity": 2, "unit_amount": 2500, "description": "750g" },
    { "name": "Shipping", "quantity": 1, "unit_amount": 1500 }
  ],
  "subtotal": 6500,
  "tax_name": "GCT",
  "tax_rate": 0.15,
  "tax_amount": 975,
  "amount": 7475
}

Référence des champs

Champ	Type	Description
line_items[].name	string	Nom de l'article affiché sur le checkout et le reçu
line_items[].quantity	integer	Quantité
line_items[].unit_amount	integer	Prix unitaire dans la plus petite unité (centimes)
line_items[].description	string	Détail optionnel sous le nom de l'article
subtotal	integer	Somme des lignes avant taxes (centimes)
tax_name	string	Étiquette comme GCT, VAT, Sales Tax
tax_rate	number	Décimal (0.15 = 15 %) — pour l'affichage
tax_amount	integer	Taxe pré-calculée en centimes — réellement facturée
amount	integer	Total facturé (centimes). Doit valoir subtotal + tax_amount.

Validation

amount est la source de vérité du paiement. subtotal + tax_amount est ce que voit le client. S'ils ne coïncident pas exactement, le client voit le détail mais est facturé amount — gardez-les cohérents sauf raison contraire.

Schémas courants

Sans taxe

Omettez tax_name, tax_rate, tax_amount. amount doit être égal à subtotal.

Taxe incluse dans le prix

Certaines juridictions caribéennes incluent la TVA dans le prix affiché. Renseignez tax_name et tax_amount pour communiquer la taxe incluse à la passerelle, mais calculez amount selon le prix attendu par le client.

Abonnement avec frais d'installation

Passez deux line items — Setup fee et First month subscription. Le token créé peut servir pour les renouvellements au seul montant récurrent. Voir Tokenisation.