Notre objet paiement dispose d'un variable shipping_info permettant de spécifier un ensemble de valeurs relatives à la livraison de vos commandes au format JSON.

Usage

En conformité avec nos CGV, cette fonctionnalité permet au marchand de partager des informations à propos de l'expedition et de la livraison des commandes payées avec la solution de paiement Alma.

Données

Données de livraison de base

Notre API peut récupérer les données:

Sélectionnées par le client lors de la création de commande
Proposées au client lors de la création de la commande

Dans les deux cas, les données sont représentées par un objet qui contient ces propriétés

Property	Type	Is Required	Description
title	String	REQUIRED	Title of the selected shipping method
amount	Number	REQUIRED	Shipping & handling fee, in cents
carrier	String	OPTIONAL	Name of shipping company
express_delivery	Boolean	OPTIONAL	Whether it's an express delivery (e.g. next-day delivery)
~~pickup_delivery~~ (deprecated)	Boolean	OPTIONAL	Deprecated, use `shipping_method` instead Whether it's a pick-up & go delivery (e.g. Mondial Relay, Relais Colis, ...)
shipping_method	Enum	OPTIONAL	Shipping method: `instore` - no shippment `pickup_store` - click & collect `pickup_point` - (e.g. Mondial Relay, Relais Colis, ...) `postal` - shipping to home

Données de livraison complètes

De manière plus complète, l'API de création de paiement peut recevoir une propriété shipping_info sous la forme suivante :

Property	Type	Is Required	Description
payment.shipping_info	Object	OPTIONAL	Shipping information for the purchase
payment.shipping_info.selected_options	Array	OPTIONAL	A list of shipping info objects selected by the customer
payment.shipping_info.available_options	Array	OPTIONAL	A list of shipping info objects representing the different shipping options the customer was presented for this payment

Examples

For a single selected shipping option

{
    "payment": {
        "purchase_amount": 50000,
        "installments_count": 3,
        ...
        "shipping_info": {
            "selected_options": [
                {
                    "title": "Colissimo suivi",
                    "carrier": "La Poste",
                    "amount": 590,
                    "express_delivery": false,
                    "shipping_method": "postal" 
                }
            ],
            "available_options": [
                {
                    "title": "Colissimo suivi",
                    "carrier": "La Poste",
                    "amount": 590,
                    "express_delivery": false,
                    "shipping_method": "postal" 
                },
                {
                    "title": "J+1 avant 13h",
                    "carrier": "Chronopost",
                    "amount": 1170,
                    "express_delivery": false,
                    "shipping_method": "postal"
                },
                {
                    "title": "Livraison en point relais",
                    "carrier": "MondialRelay",
                    "amount": 350,
                    "express_delivery": false,
                    "shipping_method": "pickup_point"
                }
            ]
        }
    },
}

For multi selected shipping option

{
    "payment": {
        "purchase_amount": 50000,
        "installments_count": 3,
        ...
        "shipping_info": {
            "selected_options": [
                {
                    "title": "Colissimo suivi",
                    "carrier": "La Poste",
                    "amount": 590,
                    "express_delivery": false,
                    "shipping_method": "postal"
                },
                {
                    "title": "Livraison en point relais",
                    "carrier": "MondialRelay",
                    "amount": 350,
                    "express_delivery": false,
                    "shipping_method": "pickup_point"
                }
            ],
            "available_options": [
                {
                    "title": "Colissimo suivi",
                    "carrier": "La Poste",
                    "amount": 590,
                    "express_delivery": false,
                    "shipping_method": "postal"
                },
                {
                    "title": "J+1 avant 13h",
                    "carrier": "Chronopost",
                    "amount": 1170,
                    "express_delivery": false,
                    "shipping_method": "postal"
                },
                {
                    "title": "Livraison en point relais",
                    "carrier": "MondialRelay",
                    "amount": 350,
                    "express_delivery": false,
                    "shipping_method": "pickup_point"
                }
            ]
        }
    },
}

👍
Ces informations de livraisons sont également éditables via le endpoint POST /v1/payment/<payment_id>si vous n'avez pas toutes les données nécessaires lors de la création de paiement.