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

    Please rate this