Aller au contenu principal
Tous les systèmes sont opérationnelsNouveautésv1
Se connecter

Mercado Pago via l'API directe

Intégrer Mercado Pago via l'API DEUNA, tester le cycle de vie des paiements et vérifier le statut final en toute sécurité.

Sur cette page

Intégrez Mercado Pago dans votre application via API.

1. Créer et commander#

Pour faire un achat, créez une commande dans DEUNA.

Faites une demande au Créer une commande endpoint.

L'API renvoie un order_token qui est utilisé tout au long du flux.

Exemple de demande

JSON
{
    "order_type": "AIRLINE_ORDER",
    "order": {
        ....
        "statement_descriptor": "DEUNA_TICKET",
        "store_code": "all",
        "airline_information": {
            "booking_items": [
                {
                    "passenger": {
                        "first_name": "Jhon",
                        "middle_name": "Paul",
                        "last_name": "Smith",
                        "date_of_birth": "2000-06-27"
                    },
                    "legs": [
                        {
                            "carrier_name": "Aeromexico",
                            "sub_total_amount": 900,
                            "tax_amount": 600,
                            "total_amount": 1500,
                            "origin": {
                                "date": "2020-02-15",
                                "time": "15:30",
                                "iata_code": "SFO"
                            },
                            "destination": {
                                "iata_code": "DBX",
                                "date": "2020-02-15",
                                "time": "15:30"
                            }
                        }
                    ]
                }
            ]
        }
    }
}

Description du champ

Découvrez comment tous les champs doivent être remplis dans l'ordre Mercado Pago via API.

Champs communs dans tous les ordres:

Chemin du champDescriptifExemple de valeur
order_typeType de commande (il doit s'agir d'AIRLINE ORDER si les informations de la compagnie aérienne sont présentes)AIRLINE_ORDER
order.statement_descriptorDescription de l'état de paiement. Longueur maximale acceptée par Mercado Pago : 13 caractères.DEUNA*SHOP123

Champs requis pour les passagers

Pour chaque passager, remplissez les renseignements personnels et chacun des éléments achetés.

Chemin du champDescriptifExemple de valeurObligatoire
order.airline_information.booking_items[0].passenger.first_namePrénom du passagerC'est un bon moment.
order.airline_information.booking_items[0].passenger.middle_nameNom du passager (le cas échéant)PaulFacultatif
order.airline_information.booking_items[0].passenger.last_nameNom de famille du passagerLes
order.airline_information.booking_items[0].passenger.date_of_birthDate de naissance du passager2000-06-27Facultatif
order.airline_information.booking_items[0].legs[0].carrier_nameCode du transporteur aérienAéroméxiqueValeur par défaut "Inconnue"
order.airline_information.booking_items[0].legs[0].total_amountMontant total pour la jambe1000
order.airline_information.booking_items[0].legs[0].sub_total_amountTotal partiel pour la jambe sans impôts1000
order.airline_information.booking_items[0].legs[0].tax_amountMontant de l'impôt0Facultatif
order.airline_information.booking_items[0].legs[0].origin.dateDate d'origine2020-02-15
order.airline_information.booking_items[0].legs[0].origin.timeHeure d'origine15:30
order.airline_information.booking_items[0].legs[0].origin.iata_codeCode IATA de l'aéroport d'origineSFOValeur par défaut "N/A
order.airline_information.booking_items[0].legs[0].destination.iata_codeCode IATA de l'aéroport de destinationDBXValeur par défaut "N/A
order.airline_information.booking_items[0].legs[0].destination.dateDate de destination2020-02-15
order.airline_information.booking_items[0].legs[0].destination.timeHeure de destination15:30

Champs de commande

ChampDescriptifExemple de valeurObligatoire
order.store_codeCode de magasin unique (valeur -all)all
order.itemsCollecte d'objets. VérifierCréer une commande Requis par ce flux Mercado Pago si les informations sur la compagnie aérienne ne sont pas incluses.
order.statement_descriptorDescription de l'état de paiement. Longueur maximale acceptée par Mercado Pago : 13 caractères.DEUNA\SHOP123

Considérations générales:

  • À propos order.items:
    • total_amount.original_amount doit être unit_price.amount * quantity.
    • total_amount.amount doit être ((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discount.
    • total_amount.total_discount est la valeur totale des rabais pour la quantité d'articles.
  • order.items_total_amount est la somme des prix unitaires des articles. Ce montant, majoré order.total_tax_amount et moins order.discount_amount, doit correspondre order.total_amount.
  • order.sub_total est la somme du prix unitaire des articles moins les rabais. Ce montant, majoré order.total_tax_amount, doit correspondre order.total_amount.

Quand Mercado Pago ouvre dans une surface de navigateur native (SafariViewController sur iOS ou Custom Tabs sur Android), vous devez configurer des liens profonds afin que l'utilisateur retourne à votre application après le résultat du paiement.

JSON
{
    "order_type": "AIRLINE_ORDER",
    "order": {
		.
		.
		.
        "callback_urls": {
            "on_success": "yourapp://payment/success",
            "on_pending": "yourapp://payment/pending",
            "on_failed": "yourapp://payment/failed"
        }
    }
}

3. Traiter l'ordre#

Faites une demande au Achat V2 Endpoint un processus de paiement.