--- title: "Créer un Paiement" method: POST path: "/payments" --- # Créer un Paiement `POST /payments` ## Request body - object - `payment` object, required — Données du paiement, à savoir : - `purchase_amount` integer, required — Montant du panier - `installments_count` integer — Nombre de prélèvements - `billing_address` object — Adresse de facturation - `company` string - `first_name` string - `last_name` string - `email` string - `phone` string - `line1` string - `line2` string - `postal_code` string - `city` string - `country` string - `customer_cancel_url` string — Url permettant au client de revenir au site marchand sans finaliser son paiement. L'ID du paiement est ajouté en paramètre `pid` de l'URL fournie, ce qui permet au marchand de procéder à des annulations de commandes, libération de stocks ou autre traitement si nécessaire. - `custom_data` string, json — Objet JSON de format libre qui vous permet d'associer au paiement Alma des données provenant de votre base de données. Typiquement utilisé pour retrouver facilement l'identifiant du panier/de la commande à l'origine du paiement. - `deferred_months` integer — Nombre de mois précédant le paiement ou la première échéance - `deferred_days` integer — Nombre de jours précédant le paiement ou la première échéance. - `ipn_callback_url` string — Url appelée de façon asynchrone par nos serveurs une fois le paiement effectué, afin de valider la commande auprès de la boutique au cas où le client aurait fermé son navigateur prématurément, ou rencontré un problème réseau lors de la redirection vers l'URL `return_url`. - `origin` string — Origine du paiement - `return_url` string — Url vers laquelle le client sera redirigé une fois le paiement effectué, généralement là où le marchand valide la commande - `shipping_address` object — Adresse de livraison de la commande. - `company` string - `first_name` string - `last_name` string - `email` string - `phone` string - `line1` string - `line2` string - `postal_code` string - `city` string - `country` string - `locale` string — Indique la langue dans laquelle communiquer avec le client: `fr`, `en`, `it`, `es`, `de`, `nl` ou `nl_BE` - `expires_after` integer — Durée en minutes au-delà de laquelle le lien de paiement n'est plus valide. Si spécifiée, prend le dessus sur la durée configurée dans le compte marchand. Lorsqu'un Payment a expiré, vous retrouverez dans ses données l'attribut `expired_at` qui donne le timestamp d'expiration effective du paiement. - `capture_method` 'manual' | 'automatic' — Détermine la stratégie de capture d'un paiement. Pour pouvoir utiliser les paiements différés "sur événement" valorisez la variable capture_method avec la valeur "manual". - `failure_return_url` string — Url de retour en cas d'échec de paiement - `cart` object — Cart content - `items` object[] — Cart content - `title` string, required — Product name - `quantity` integer, required — Item quantity - `line_price` integer, required — Item price line in cents - `picture_url` string, required — Item picture url - `merchant_covers_all_fees` boolean — Désactive le partage des frais, le consommateur ne paiera pas de frais, ils seront à la charge du marchand - `customer` object — Données du client, à savoir : - `id` string — Identifiant du client dans notre système (Alma) - `created` string, date-time — Date de création du client dans notre système (Alma) - `first_name` string — Prénom - `last_name` string — Nom de famille - `addresses` object[] — Liste des adresses liées à ce client - `company` string - `first_name` string - `last_name` string - `email` string - `phone` string - `line1` string - `line2` string - `postal_code` string - `city` string - `country` string - `email` string — Email du client - `phone` string — Téléphone du client - `birth_date` string — Date de naissance du client (yyyy-mm-dd) - `card` object — Objet [Card] https://docs.getalma.eu/reference/card - `banking_data_collected` boolean — `True` si les données bancaires de ce client ont été collectées. Les données bancaires des clients ne sont jamais accessibles et sont supprimées une fois qu'elles ne sont plus utilisées dans le cadre du paiement - `is_business` boolean — Vous travaillez avec des entreprises, vous devez toujours envoyer `is_business` comme `true`, car vos clients ne pourront pas modifier cette valeur, et cela aura un impact sur leur parcours. - `business_id_number` string — Le numéro d'identification de l'entreprise - `business_name` string — Nom de l'entreprise - `account_id` string — Identifiant du client dans votre système (marchand) - `account_created` string, date-time — Date de création du compte client dans votre système (marchand) - `previous_orders_count` integer — Nombre de commandes passées par le client (votre historique d'achats) - `order` object — Données de la commande associée au paiement au format Order, voir [Créer un order](https://docs.getalma.eu/reference/ajouter-une-order-%C3%A0-un-payment) - `merchant_reference` string — Référence marchand de la commande, présentée au client, permettant de faire le lien entre une commande et un paiement sur Alma - `merchant_url` string — Url de la page du backoffice marchand correspondant à la commande - `data` object — Dictionnaire contenant des données arbitraires entrées par le marchand - `customer_url` string — Url de la page de détails de commande visible par le client - `comment` string — Commentaire du marchand sur la commande ## Response `200` 200 - object ## Other responses - `400` — 400 --- [API](https://skmtc.dev/almapay/apis/alma-sandbox-api.md) · [All operations](https://skmtc.dev/almapay/apis/alma-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/almapay/alma-sandbox-api/revisions/71ebf8797c52/schema)