Verifique quais campos vocĂȘ pode enviar de acordo com o seu setor para melhorar sua aprovação.
Atenção
Uso de exemplosEssas informaçÔes funcionam apenas para a API de PreferĂȘncias.
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome type
String Tipo description
String Descrição picture_url
String Imagem URL category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio
Object payer
Tipo descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object Telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nao Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Object shipment
Tipo Descrição receiver_address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal state_name
String ProvĂncia city_name
String Cidade street_number
Integer NĂșmero da rua express_shipment
Boolean True
se Ă©, False
se nĂŁo Ă©.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"picture_url": "",
"description": "Descrição de produto",
"type": "test",
"category_id": "fashion",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Maria",
"last_name": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"shipments": {
"mode": "not_specified",
"receiver_address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"city_name": "Osasco",
"state_name": "SĂŁo Paulo",
"street_number": 1000
},
"express_shipment": false
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio warranty
Boolean True
se o produto tiver garantia, False
se nĂŁo tiver.
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object Telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Object shipment
Tipo Descrição local_pickup
Boolean True
se retira na agĂȘncia ou na loja, False
se nĂŁo retira.receiver_address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal state_name
String ProvĂncia city_name
String Cidade street_number
Integer NĂșmero da rua express_shipment
Boolean True
se Ă©, False
se nĂŁo Ă©.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"category_id": "phones",
"quantity": 1,
"unit_price": 150,
"warranty": false,
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.comâ,
"first_name": "Maria",
"last_name": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"shipments": {
"mode": "not_specified",
"receiver_address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"city_name": "Osasco",
"state_name": "SĂŁo Paulo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio category_descriptor
Object Descrição da categoria event_date
Date Data do evento
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object Telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Object shipment
Tipo Descrição receiver_address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal state_name
String ProvĂncia city_name
String Cidade street_number
Integer NĂșmero da rua express_shipment
Boolean True
se Ă©, False
se nĂŁo Ă©.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"category_id": "entertainment",
"quantity": 1,
"unit_price": 150,
"category_descriptor":{
"event_date": "2022-03-12T12:58:41.425-04:00"
},
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Maria",
"last_name": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"shipments": {
"mode": "not_specified",
"receiver_address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"city_name": "Osasco",
"state_name": "SĂŁo Paulo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome description
String Descrição category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio warranty
Boolean True
se o produto tiver garantia, False
se nĂŁo tiver.
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Object shipment
Tipo Descrição receiver_address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal state_name
String ProvĂncia city_name
String Cidade street_number
Integer NĂșmero da rua express_shipment
Boolean True
se Ă©, False
se nĂŁo Ă©.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"picture_url": "",
"description": "Descrição de produto",
"category_id": "home",
"quantity": 1,
"unit_price": 150,
"warranty": false,
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"first_name": "Maria",
"last_name": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"shipments": {
"mode": "not_specified",
"receiver_address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"city_name": "Osasco",
"state_name": "SĂŁo Paulo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"picture_url": "",
"description": "Descrição de produto",
"category_id": "services",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome description
String Descrição picture_url
String Imagem URL category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Object shipment
Tipo Descrição receiver_address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal state_name
String ProvĂncia city_name
String Cidade street_number
Integer NĂșmero da rua express_shipment
Boolean True
se Ă©, False
se nĂŁo Ă©.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/us/home/failure",
"pending": "https://www.mercadopago.com/us/home/pending",
"success": "https://www.mercadopago.com/us/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"picture_url": "",
"description": "Descrição de produto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"shipments": {
"mode": "not_specified",
"receiver_address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"city_name": "Osasco",
"state_name": "SĂŁo Paulo",
"street_number": 1000
},
"express_shipment": false,
"local_pickup": false
}
}'
Serviços governamentais e pĂșblicos
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome description
String Descrição category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio category_descriptor
Object Descrição da categoria event_date
Date Data do evento
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Object shipment
Tipo Descrição receiver_address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal state_name
String ProvĂncia city_name
String Cidade street_number
Integer NĂșmero da rua
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Serviço",
"picture_url": "",
"description": "Descrição de serviço",
"category_id": "services",
"quantity": 1,
"unit_price": 150,
"category_descriptor":{
"event_date": "2022-03-12T12:58:41.425-04:00"
},
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"shipments": {
"mode": "not_specified",
"receiver_address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"city_name": "Osasco",
"state_name": "SĂŁo Paulo",
"street_number": 1000
}
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome description
String Descrição category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio category_descriptor
Object Descrição de la categorĂa. passenger
Object InformaçÔes adicionais sobre passageiros. first_name
String Nome last_name
String Sobrenome identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação route
Object InformaçÔes da rota departure
String SaĂda destination
String Chegada departure_date_time
Date Data de saĂda. Exemplo: 2024-06-20T06:20:00.000-04:00. arrival_date_time
Date Data de chegada company
String Companhia
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Serviço",
"description": "Descrição de serviço",
"category_id": "travels",
"category_descriptor":{
"passenger": {
"first_name": "Maria",
"last_name": "Silva",
"type": "CPF",
"number": 12345678
},
"route": {
"departure": "Osasco",
"destination": "Londres",
"departure_date_time": "2022-03-12T12:58:41.425-04:00",
"arrival_date_time": "2022-03-14T12:58:41.425-04:00",
"company": "CompañĂa"
}
},
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio event_date
Date Data do evento category_descriptor
Object Descrição da categoria passenger
Object InformaçÔes adicionais sobre passageiros first_name
String Nome last_name
String Sobrenome identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Serviço",
"description": "Descrição de serviço",
"category_id": "travels",
"category_descriptor": {
"event_date": "2022-03-12T12:58:41.425-04:00"
"passenger": {
"first_name": "Maria",
"last_name": "Silva",
"type": "CPF",
"number": 12345678
}
},
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"picture_url": "",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome description
String Descrição category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Object shipment
Tipo Descrição receiver_address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal state_name
String ProvĂncia city_name
String Cidade street_number
Integer NĂșmero da rua floor
String Piso apartment
String Apartamento local_pickup
Boolean True
se retira na agĂȘncia ou na loja, False
se nĂŁo retira.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"picture_url": "",
"description": "Descrição de produto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_prime_user": false,
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"shipments": {
"mode": "not_specified",
"local_pickup": false,
"receiver_address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"city_name": "Osasco",
"state_name": "SĂŁo Paulo",
"street_number": 1000
"floor": "12",
"apartment": "B"
}
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome description
String Descrição category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Object shipment
Tipo Descrição receiver_address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal state_name
String ProvĂncia city_name
String Cidade street_number
Integer NĂșmero da rua floor
String Piso apartment
String Apartamento local_pickup
Boolean True
se retira na agĂȘncia ou na loja, False
se nĂŁo retira.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"picture_url": "",
"description": "Descrição de produto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_first_purchase_online": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
},
"shipments": {
"mode": "not_specified",
"local_pickup": false,
"receiver_address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"city_name": "Osasco",
"state_name": "SĂŁo Paulo",
"street_number": 1000
"floor": "12",
"apartment": "B"
}
}
}'
Adicione todas as informaçÔes adicionais que vocĂȘ deseja.
Array items
Tipo Descrição id
String CĂłdigo title
String Nome description
String Descrição category_id
String Categoria quantity
Integer Quantidade unit_price
Float Preço unitårio
Object payer
Tipo Descrição first_name
String Nome last_name
String Sobrenome identification
Object Dados de identificação identification_type
String Tipo de identificação identification_number
String NĂșmero de identificação phone
Object telefone area_code
Integer CĂłdigo de ĂĄrea number
Integer NĂșmero de telefone address
Object Dados do endereço zip_code
String CĂłdigo postal street_name
String Nome da rua street_number
Integer NĂșmero da rua authentication_type
Enum Tipo de autenticação ("Gmail" - "Facebook" - "Web Nativa" - "Outro") registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean True
se Ă©, False
se nĂŁo Ă©.is_first_purchase_online
Boolean True
se Ă©, False
se nĂŁo Ă©.last_purchase
Date Data da Ășltima compra no site.
Copiar curl --location --request POST 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2025-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "BRL",
"title": "Produto",
"picture_url": "",
"description": "Descrição de produto",
"category_id": "others",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "987654321"
},
"address": {
"zip_code": "52",
"street_name": "Av. das NaçÔes Unidas",
"street_number": 1000
},
"identification": {
"identification_type": "CPF",
"identification_number": "12345678"
},
"email": "john@yourdomain.com",
"name": "Maria",
"surname": "Silva",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_first_purchase_online": false,
"is_prime_user": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
}
}'
Estes sĂŁo os dados especĂficos para a indĂșstria de gambling que podem ser adicionados Ă sua integração para melhorar a aprovação dos pagamentos.
Array items
Tipo Descrição id
String Código de identificação do item. title
String Nome do item. warranty
Boolean true
se Ă©, false
se nĂŁo Ă©.category_id
String Categoria do item. quantity
Integer Quantidade de unidades do item. unit_price
Float Preço unitĂĄrio atribuĂdo ao item. Pode ser um valor inteiro ou em casas decimais.
Object payer
Tipo Descrição first_name
String Nome do comprador. last_name
String Sobrenome do comprador. identification
Object Dados de identificação do comprador. type
String Tipo de identificação. Estå dentro do objeto identification
. number
String NĂșmero de identificação. EstĂĄ dentro do objeto identification
. phone
Object Telefone do comprador. area_code
Integer CĂłdigo de ĂĄrea do comprador. EstĂĄ dentro do objeto phone
. number
Integer NĂșmero de telefone do comprador. EstĂĄ dentro do objeto phone
. address
Object Dados do endereço do comprador. zip_code
String CĂłdigo postal do comprador. EstĂĄ dentro do objeto address
. street_name
String Nome da rua do endereço do comprador. Estå dentro do objeto address
. street_number
Integer NĂșmero da rua do endereço do comprador. EstĂĄ dentro do objeto address
. authentication_type
Enum Tipo de autenticação. Pode ser "Gmail", "Facebook", "Web Nativa" ou "Outro". registration_date
Date Data de registro do comprador no site. is_prime_user
Boolean Indica se o usuĂĄrio Ă© premium . Caso seja, use true
e, caso nĂŁo seja, use false
. is_first_purchase_online
Boolean Indica se Ă© a primeira compra do cliente. Caso seja, use true
e, caso nĂŁo seja, use false
. last_purchase
Date Data da Ășltima compra no site.
Copiar curl --location 'https://api.mercadopago.com/checkout/preferences' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data-raw '{
"auto_return": "approved",
"back_urls": {
"failure": "https://www.mercadopago.com/home/failure",
"pending": "https://www.mercadopago.com/home/pending",
"success": "https://www.mercadopago.com/home/success"
},
"notification_url": "https://webhook.site/xyz",
"expires": false,
"external_reference": "order-123",
"date_of_expiration": "2026-03-12T12:58:41.425-04:00",
"items": [
{
"id": "1234",
"currency_id": "MXN",
"title": "Producto",
"picture_url": "",
"description": "DescripciĂłn de producto",
"category_id": "lottery",
"quantity": 1,
"unit_price": 150
}
],
"payer": {
"phone": {
"area_code": "11",
"number": "619 911 306"
},
"address": {
"zip_code": "52",
"street_name": "Insurgentes Sur",
"street_number": 1000
},
"identification": {
"identification_type": "-",
"identification_number": "12345678"
},
"email": "carlota.castellanos@yourdomain.com",
"name": "Carlota",
"surname": "Castellanos",
"date_created": "",
"authentication_type": "Facebook",
"registration date": "2015-06-02T12:58:41.425-04:00",
"is_first_purchase_online": false,
"is_prime_user": false,
"last_purchase": "2020-01-02T12:58:41.425-04:00"
},
"payment_methods": {
"excluded_payment_methods": [
{
"id": ""
}
],
"default_installments": null,
"default_payment_method_id": null,
"excluded_payment_types": [
{
"id": ""
}
],
"installments": null
}
}'