Saltar al contenido principal
POST
Esta solicitud crea un recurso de cliente. Debes proporcionar varios parámetros del cliente en el cuerpo de la solicitud, entre ellos el identificador único del cliente en el comercio externo, la información personal y las direcciones de facturación y de envío. Al crear un cliente se genera un id de cliente que puedes usar para iniciar el checkout.
merchant_customer_id tiene alcance de organización, no de cuentaSi tu organización tiene varias cuentas, merchant_customer_id debe ser único entre todas ellas. Si creas un cliente desde una cuenta con un id que ya usa otra cuenta de la misma organización, se devuelve CUSTOMER_ID_DUPLICATED. Consulta Cuentas para saber cómo estructurar los ids si gestionas varias empresas dentro de una organización.
ImportanteHay ciertos objetos que no son obligatorios al crear un “cliente”. Sin embargo, cuanta más información proporciones, más puede ayudar a mejorar las tasas de aprobación, conversión y prevención del fraude.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Cuerpo

application/json
merchant_customer_id
string
requerido

El identificador único del cliente en el comercio externo (MAX 255; MIN 3). Es único por organización, no por cuenta: reutilizar un id ya usado por otra cuenta de la misma organización devuelve CUSTOMER_ID_DUPLICATED.

merchant_customer_created_at
string<date-time>

Fecha de registro del cliente en la plataforma del comercio (MAX 27; MIN 27; ISO 8601)

first_name
string

El nombre del cliente (MAX 255; MIN 3).

last_name
string

El apellido del cliente (MAX 255; MIN 3).

gender
string

El género del cliente.

date_of_birth
string

La fecha de nacimiento del cliente en formato YYYY-MM-DD (MAX 10; MIN 10).

email
string

El correo electrónico del cliente (MAX 255; MIN 3).

nationality
enum<string>

La nacionalidad del cliente (MAX 2; MIN 2; ISO 3166-1 [blocked]).

Opciones disponibles:
AF,
AX,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BQ,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
CV,
KH,
CM,
CA,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CG,
CD,
CK,
CR,
CI,
HR,
CU,
CW,
CY,
CZ,
DK,
DJ,
DM,
DO,
EC,
EG,
SZ,
GQ,
ER,
EE,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GG,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IM,
IL,
IT,
JM,
JP,
JE,
JO,
KZ,
KE,
KI,
KR,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MK,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
ME,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MP,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RE,
RO,
RU,
RW,
BL,
SH,
KN,
LC,
MF,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
RS,
SC,
SL,
SG,
SX,
SK,
SI,
SB,
SO,
ZA,
GS,
SS,
ES,
LK,
SD,
SR,
SJ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TR,
TM,
TC,
TV,
UG,
UA,
AE,
GB,
US,
UM,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW
country
enum<string>

El país del cliente (MAX 2; MIN 2; ISO 3166-1 [blocked]).

Opciones disponibles:
AF,
AX,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BQ,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
CV,
KH,
CM,
CA,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CG,
CD,
CK,
CR,
CI,
HR,
CU,
CW,
CY,
CZ,
DK,
DJ,
DM,
DO,
EC,
EG,
SZ,
GQ,
ER,
EE,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GG,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IM,
IL,
IT,
JM,
JP,
JE,
JO,
KZ,
KE,
KI,
KR,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MK,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
ME,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MP,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RE,
RO,
RU,
RW,
BL,
SH,
KN,
LC,
MF,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
RS,
SC,
SL,
SG,
SX,
SK,
SI,
SB,
SO,
ZA,
GS,
SS,
ES,
LK,
SD,
SR,
SJ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TR,
TM,
TC,
TV,
UG,
UA,
AE,
GB,
US,
UM,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW
document
object

Especifica el objeto de documento del cliente, con su número y tipo. Este objeto no es obligatorio. Sin embargo, si envías esta información, mejorarás la experiencia de pago de tu usuario.

phone
object

Especifica el objeto de número de teléfono del cliente. Este objeto no es obligatorio. Sin embargo, si envías esta información, mejorarás la experiencia de pago de tu usuario.

billing_address
object

Especifica el objeto de dirección de facturación del cliente. Este objeto no es obligatorio. Sin embargo, si envías esta información, mejorarás la experiencia de pago de tu usuario.

shipping_address
object

Especifica el objeto de dirección de envío del cliente. Este objeto no es obligatorio. Sin embargo, si envías esta información, mejorarás la experiencia de pago de tu usuario.

metadata
object[]

Especifica una lista de objetos de metadatos. Puedes agregar hasta 50 objetos de metadatos.

Respuesta

201

id
string
Ejemplo:

"bf64527c-5531-4ece-bf2c-51a8e775d8e1"

merchant_customer_id
string
Ejemplo:

"AAAAAAAAAAAAAA0002"

first_name
string
Ejemplo:

"John"

last_name
string
Ejemplo:

"Doe"

gender
string
Ejemplo:

"M"

date_of_birth
string
Ejemplo:

"1990-02-28"

email
string
Ejemplo:

"john.doe@email.com"

nationality
string
Ejemplo:

"US"

country
string
Ejemplo:

"US"

document
object
phone
object
billing_address
object
shipping_address
object
metadata
object[]
created_at
string
Ejemplo:

"2025-04-24T18:54:54.351969Z"

updated_at
string
Ejemplo:

"2025-04-24T18:54:54.351971Z"

merchant_customer_created_at
string
Ejemplo:

"2022-05-09T20:46:54.786342Z"