Registro de comercios
Registra y edita el perfil, el domicilio fiscal y el contacto principal de un comercio mexicano.
En la consola de demostración pública, usa Comercios para registrar un negocio mexicano ficticio. Cualquier persona puede listar, consultar, crear y actualizar los perfiles compartidos desde la consola o la API sin iniciar sesión. Usa únicamente datos ficticios, incluidos el RFC, el domicilio fiscal y el contacto principal.
Registra un comercio
- Ingresa el nombre comercial, es decir, el nombre con el que identificas al negocio. Por ejemplo, una tienda ficticia podría llamarse Papelería Ejemplo.
- Ingresa el nombre registrado y el RFC en el perfil fiscal. Selecciona Persona física para un contribuyente individual o Persona moral para una empresa. Captura el nombre registrado de la persona o la razón social de la empresa, como Papelería Ejemplo, S.A. de C.V. en un ejemplo ficticio. DotPay valida el formato del RFC según el tipo de contribuyente.
- Captura el domicilio fiscal. Busca el código postal, selecciona la ubicación que corresponda e ingresa por separado la calle y los números exterior e interior. Cada comercio tiene su propio registro de Dirección fiscal.
- Busca el giro comercial principal del negocio por nombre o código en el catálogo y selecciónalo. DotPay conserva el código, el sistema de clasificación y la edición.
- Captura el contacto principal en el mismo formulario. Ingresa el nombre completo, correo electrónico, número de teléfono nacional y prefijo de marcación, como
+52para México. Al registrar el comercio, se crea una Persona nueva. El nombre registrado del perfil fiscal y el nombre de la Persona son campos separados, aunque se refieran al mismo individuo. - Guarda tras completar los campos obligatorios. Si algún dato obligatorio no pasa la validación, se rechaza el registro completo.
Consulta y edita comercios
Abre un comercio desde la lista para consultar su perfil, domicilio fiscal y contacto principal. Edita el perfil y guarda para aplicar los cambios.
Si otro comercio de la demostración compartida usa el mismo RFC, la consola muestra un aviso informativo. Puedes guardar de todas formas. Los comercios con el mismo RFC conservan perfiles separados.
Registra un comercio mediante la API
Consulta el catálogo de giros y el catálogo de códigos postales para obtener los valores. Los valores de este ejemplo pertenecen a los catálogos ficticios.
Guarda este ejemplo en comercio.json.
{
"commercial_name": "Tienda de Prueba",
"business_activity": {
"system": "dotpay-synthetic-mcc",
"edition": "test-v1",
"code": "0001"
},
"persona": {
"full_name": "Luz Ejemplo",
"email": "luz@example.com",
"phone_number": "5550000100",
"country_code": "+52"
},
"fiscal_profile": {
"taxpayer_type": "persona_moral",
"registered_name": "Comercio de Prueba",
"rfc": "ZZZ000101ZZ0",
"address": {
"country": "MX",
"postal_code": "01234",
"catalog_version": "synthetic-v1",
"entry_id": "09:001:0001",
"street": "Calle de Prueba",
"exterior_number": "S/N",
"interior_number": null
}
}
}Envía el ejemplo a la API de demostración pública.
curl -i https://api.dotpay.mx/merchants \
-H 'Content-Type: application/json' \
--data-binary @comercio.jsonUsa el id de la respuesta 201 Created para consultar o actualizar el comercio. Para actualizarlo, envía todos los campos editables mediante PUT. Para el aviso de RFC, envía rfc a la consulta de RFC e incluye exclude_merchant_id al editar. La respuesta devuelve el valor booleano match.
Si recibes 400, lee la respuesta de error y revisa los campos obligatorios, el formato del RFC y los valores elegidos en los catálogos. Consulta los esquemas y las respuestas en la referencia de API de Comercios.