Mercado Pago - Create Customer

Description

Creates a new customer in Mercado Pago to save cards and payment methods. Customers facilitate recurring payments and one-click checkout.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Mercado Pago credentials
email	string	Yes	Customer email
first_name	string	No	Customer first name
last_name	string	No	Customer last name
phone_area_code	string	No	Phone area code
phone_number	string	No	Phone number
identification_type	string	No	Document type (DNI, CPF, etc.)
identification_number	string	No	Document number
description	string	No	Customer description/notes

Credentials

This module requires a mercadopago type credential with the following fields:

• Access Token: Mercado Pago access token (obtained from the developer dashboard)

Output

{
  "success": true,
  "customer": {
    "id": "123456789",
    "email": "cliente@email.com",
    "first_name": "Juan",
    "last_name": "Pérez",
    "phone": {
      "area_code": "11",
      "number": "12345678"
    },
    "identification": {
      "type": "DNI",
      "number": "12345678"
    },
    "date_created": "2024-01-15T10:00:00.000-03:00"
  },
  "customer_id": "123456789",
  "message": "Cliente 123456789 creado"
}

Document Types by Country

• Argentina: DNI, CUIT, CUIL
• Brazil: CPF, CNPJ
• Mexico: RFC, CURP, INE
• Colombia: CC, CE, NIT
• Chile: RUT
• Peru: DNI, CE, RUC
• Uruguay: CI, RUT

Usage Example

{
  "email": "cliente@email.com",
  "first_name": "Juan",
  "last_name": "Perez",
  "phone_area_code": "11",
  "phone_number": "12345678",
  "identification_type": "DNI",
  "identification_number": "12345678",
  "description": "Cliente VIP"
}

API Used

• Endpoint: POST /v1/customers
• Documentation: Mercado Pago Customers API

Notes

• Email must be unique per customer
• Once created, cards can be associated using the JS SDK
• Customers facilitate recurring payments and one-click checkout

Related Nodes

• MercadopagoGetCustomers - Get customers
• MercadopagoCreatePayment - Create payment
• MercadopagoCreateSubscription - Create subscription