Mercado Pago tramite API diretta

In questa pagina

1. Creare e ordinare
2. callback urls per i Link Profiori
3. Elaborare l'ordine

Integra Mercado Pago nella tua applicazione tramite API.

1. Creare e ordinare#

Per effettuare un acquisto, creare un ordine in DEUNA.

Fai una richiesta al Creare un Ordine endpoint.

L'API restituisce un order_token che viene utilizzato durante il flusso.

Esempio di richiesta

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"
                            }
                        }
                    ]
                }
            ]
        }
    }
}

Descrizione del campo

Scopri come tutti i campi devono essere riempiti nell'ordine Mercado Pago tramite API.

Campi comuni in tutti gli ordini:

Sentiero di campo	Descrizione	Esempio di valore
order_type	Tipo di ordine (deve essere AIRLINE ORDER se sono presenti le informazioni della compagnia aerea)	AIRLINE_ORDER
order.statement_descriptor	Descrizione della dichiarazione per il pagamento. Lunghezza massima accettata da Mercado Pago: 13 caratteri.	*DEUNASHOP123**

Campi obbligatori del passeggero

Per ogni passeggero, compilare le informazioni personali e ciascuna delle gambe acquistate.

Sentiero di campo	Descrizione	Esempio di valore	Obbligatorio
order.airline_information.booking_items[0].passenger.first_name	Nome del passeggero	John John.
order.airline_information.booking_items[0].passenger.middle_name	Nome medio del passeggero (se applicabile)	Paul Paul	Facoltativo
order.airline_information.booking_items[0].passenger.last_name	Nome del passeggero	Smith
order.airline_information.booking_items[0].passenger.date_of_birth	Data di nascita del passeggero	2000-06-27	Facoltativo
order.airline_information.booking_items[0].legs[0].carrier_name	Codice vettore aereo	Aeromessico	Valore predefinito "Sconosciuto"
order.airline_information.booking_items[0].legs[0].total_amount	Importo totale per la gamba	1000
order.airline_information.booking_items[0].legs[0].sub_total_amount	Totale parziale per la gamba senza tasse	1000
order.airline_information.booking_items[0].legs[0].tax_amount	Importo fiscale	0	Facoltativo
order.airline_information.booking_items[0].legs[0].origin.date	Data di origine	2020-02-15
order.airline_information.booking_items[0].legs[0].origin.time	Tempo di origine	15:30
order.airline_information.booking_items[0].legs[0].origin.iata_code	Codice IATA dall'aeroporto di origine	SFO	Valore predefinito "N/A"
order.airline_information.booking_items[0].legs[0].destination.iata_code	Destinazione aeroporto Codice IATA	DBX	Valore predefinito "N/A"
order.airline_information.booking_items[0].legs[0].destination.date	Data di destinazione	2020-02-15
order.airline_information.booking_items[0].legs[0].destination.time	Ora di destinazione	15:30

Ordinare i campi

Campo	Descrizione	Esempio di valore	Obbligatorio
order.store_code	Codice di negozio unico (valore “tutto”)	`all`
order.items	Collezione di articoli. Check	Creare un Ordine	Richiesto da questo flusso Mercado Pago se le informazioni sulla compagnia aerea non sono incluse.
order.statement_descriptor	Descrizione della dichiarazione per il pagamento. Lunghezza massima accettata da Mercado Pago: 13 caratteri.	DEUNA\SHOP123

Considerazioni generali:

Informazioni su order.items:
- total_amount.original_amount deve essere unit_price.amount * quantity.
- total_amount.amount deve essere ((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discount.
- total_amount.total_discount è il valore totale degli sconti per la quantità di articoli.
order.items_total_amount è la somma dei prezzi unitari degli articoli. Questo importo, più order.total_tax_amount e meno order.discount_amount, deve corrispondere order.total_amount.
order.sub_total è la somma del prezzo unitario degli articoli meno gli sconti. Questo importo, più order.total_tax_amount, deve corrispondere order.total_amount.

2. callback urls per i Link Profiori#

Quando Mercado Pago si apre in una superficie di browser madre (SafariViewController su iOS o Custom Tabs su Android), è necessario configurare i link profondi in modo che l'utente ritorni alla tua app dopo il risultato del pagamento.

JSON

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

3. Elaborare l'ordine#

Fai una richiesta al V2 acquisto endpoint un processo il pagamento.