/v1/customers

BASE URI https://api.mercadopago.com/v1/customers

HTTP Request

curl

 curl -X POST \
  'https://api.mercadopago.com/v1/customers?access_token=ACCESS_TOKEN_ENV' \ 
  -d '{
        "email": "bruno@gmail.com",
        "first_name": "Bruce",
        "last_name": "Wayne",
        "phone": {
            "area_code": "023",
            "number": "12345678"
        },
        "identification": {
            "type": "DNI",
            "number": "12345678"
        },
        "address": {
            "zip_code": "SG1 2AX",
            "street_name": "Old Knebworth Ln"
        },
        "description": "Lorem Ipsum"
    }' 

Request Params

ParameterTypeDescription
first_name String (a-zA-Z) Nombre del cliente.
last_name String (a-zA-Z) Apellido del cliente.
phone Object Teléfono del cliente.
area_code String Código de área.
number String Número de teléfono.
identification Object Información sobre la identificación del cliente.
type String Tipo de identificación.
number String Número de identificación.
default_address String Dirección por defecto del cliente.
address Object Información sobre la dirección por defecto del cliente.
id String Identificador de la dirección del cliente.
zip_code String Código postal.
street_name String Calle.
street_number String Número.
date_registered Date(ISO_8601) Fecha de registro del cliente.
description String Descripción del cliente.
metadata Object Metadata del cliente.
default_card String Tarjeta por defecto del cliente.

HTTP Response

json

 {
    "id": "000000001-sT93QZFAsfxU9P5",
    "email": "bruno@gmail.com",
    "first_name": "Bruce",
    "last_name": "Wayne",
    "phone": {
        "area_code": "023",
        "number": "12345678"
    },
    "identification": {
        "type": "DNI",
        "number": "12345678"
    },
    "address": {
        "id": null,
        "zip_code": "SG1 2AX",
        "street_name": "Old Knebworth Ln",
        "street_number": null
    },
    "date_registered": null,
    "description": "Lorem Ipsum",
    "date_created": "2018-02-20T11:36:23.541-04:00",
    "date_last_updated": null,
    "metadata": {},
    "default_card": null,
    "default_address": null,
    "cards": [],
    "addresses": [],
    "live_mode": false
} 

Error Codes

CodeDescription
400 BAD_REQUEST
100 Las credenciales son requeridas.
101 El cliente ya existe.
102 missing customer id.
103 El parámetro debe ser un objeto
104 La longitud del parámetro es muy grande.
105 El identificador de cliente es inválido.
106 El formato de email es inválido.
107 first_name inválido.
108 last_name inválido.
109 phone.area_code inválido.
110 phone.number inválido.
111 identification.type inválido.
112 identification.number inválido.
113 address.zip_code inválido.
114 address.street_name inválido.
115 date_registered format inválido.
116 description inválido.
117 metadata inválido.
118 El body debe ser un objeto JSON.
119 La tarjeta es requerida.
120 Tarjeta no encontrada.
121 La tarjeta es inválida.
122 card data inválida.
123 payment_method_id es requerido.
124 issuer_id es requerido.
125 Parámetros inválidos.
126 Parámetro inválido. No se puede actualizar el email.
127 Parámetro inválido. No se puede resolver el medio de pago de la tarjeta, revisa payment_method_id y issuer_id.
128 El formato de email es inválido. Usa 'test_payer_[0-9]{1,10}@testuser.com'.
129 El cliente llego al máximo permitido de tarjetas.
140 Dueño de tarjeta inválido.
150 Usuarios inválidos involucrados.
200 Formato de rango inválido (range=:date_parameter:after::date_from,before::date_to).
201 El atributo del rango debe pertenecer a la entidad date.
202 Parámetro 'after' inválido. Debería ser date[iso_8601].
203 Parámetro 'before' inválido. Debería ser date[iso_8601].
204 Formato inválido de filtros.
205 Formato de consulta inválido.
206 Los atributos a ordenar deben perstenecer a la entidad 'customer'.
207 El orden del filtro debe ser 'asc' o 'desc'.
208 Formato inválido del parámetro 'sort'.
401 UNAUTHORIZED
unauthorized No autorizado.
404 NOT_FOUND
not_found not_found.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.