Billing data

To bill a sale you need to have the buyer's data which are available in Orders resource, more specifically, in /orders/order_id/billing_info.

Contents

Query billing data

To get the information about a buyer's billing data contained in an order, make the following call. Call
GET https://api.mercadolibre.com/orders/$order_id/billing_info?access_token={access_token}
Example
GET https://api.mercadolibre.com/orders/1691789796/billing_info?access_token=ACCESS_TOKEN
Response (these are examples of persons: MLB and MLA Individual/Legal Entity) MLA - Indivudual Order Id: 1691789796 User id: 316440831
{
  "billing_info": {
    "additional_info": [
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STREET_NUMBER",
        "value": "3571"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "LAST_NAME",
        "value": "Gomez Blanco"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_NUMBER",
        "value": "32659430"
      },
      {
        "type": "DOC_TYPE",
        "value": "DNI"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "FIRST_NAME",
        "value": "María Lupita"
      },
{
type: "NEIGHBORHOOD",
value: "Divino"
},
    ],
    "doc_number": "32659430",
    "doc_type": "DNI"
  }
}

MLA - Legal Entity Order Id: 1691801481 User id: 316440831
{
  "billing_info": {
    "additional_info": [
      {
        "type": "DOC_NUMBER",
        "value": "30703088534"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STATE_REGISTRATION",
        "value": "30703088534"
      },
      {
        "type": "TAXPAYER_TYPE_ID",
        "value": "IVA Responsable Inscripto"
      },
      {
        "type": "BUSINESS_NAME",
        "value": "Mercado Libre S.R.L"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "STREET_NUMBER",
        "value": "SN"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_TYPE",
        "value": "CUIT"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
{
type: "NEIGHBORHOOD",
value: "Divino"
},
    ],

    "doc_number": "30703088534",
    "doc_type": "CUIT"
  }
}

Types and values for additional info

These are the possible types/values (type/value en additional_info) for different players: MLB Individual
  • first_name: buyer's name/s
  • last_name: buyer's last name
  • doc_type: type of document
  • doc_number: number of document
  • zip_code: buyer's zip code
  • street_name: buyer's billing address street name
  • street_number: buyer's billing address street number
  • - Possible values: any string, "SN" for street without number
  • comment: additional comment on buyer's billing address
  • state_name: buyer's billing address state
  • city_name: buyer's billing address city
MLB Legal Entity
  • business_name: Buying legal entity name
  • taxpayer_type_id: legal entity VAT position
  • - Possible values: between "taxpayer" (tax payer), "not_taxpayer" (non tax payer)
  • state_registration:
  • - doc_type: type of document - doc_number: number of document - zip_code: buyer's zip code
  • street_name: buyer's billing address street name
  • street_number: buyer's billing address street number
  • - Possible values: any string, "SN" for street without number
  • comment: additional comment on buyer's billing address
  • state_name: buyer's billing address state
  • city_name: buyer's billing address city
MLA Individual
  • first_name: buyer's name/s
  • last_name: buyer's last name
  • doc_type: type of document
  • doc_number: number of document
  • zip_code: buyer's zip code
  • street_name: buyer's billing address street name
  • street_number: buyer's billing address street number
  • - Possible values: any string, "SN" for street without number
  • comment: buyer's billing address floor
  • state_name: buyer's billing address state
  • city_name: buyer's billing address city
MLA Legal Entity
  • business_name: Buying legal entity name
  • taxpayer_type_id: legal entity VAT position
  • - Possible values: between "monotax" (non-VAT taxpayer) and "VAT"
  • state_registration:
  • - doc_type: type of document - doc_number: number of document - zip_code: buyer's zip code
  • street_name: buyer's billing address street name
  • street_number: buyer's billing address street number - Possible values: any string, "SN" for street without number
  • comment: buyer's billing address floor
  • state_name: buyer's billing address state
  • city_name: buyer's billing address city
DOC_TYPE's
  • MLA
  • - DNI - CUIT
  • MLB
  • - CPF - CNPJ
  • MLC
  • - RUT
  • MCO
  • - CC - CE - NIT
  • MLV
  • - CI - RIF - Pasaporte
  • MLU
  • - CI - RUT
  • MPE
  • - DNI - CE

Be part of our community