Crear Tercero para Cross Border

POST https://payment-backend-sandbox.milio.com.co/external-payout/cross-border/v1/create-provider

Este endpoint permite registrar un nuevo tercero con sus datos básicos para operaciones cross-border.

Body

Parámetro	Tipo	Descripción	Requerido
tradeName	string	Nombre comercial del tercero.	Sí
legalName	string	Nombre legal completo del tercero.	Sí
name	string	Primer nombre o nombre de pila.	Sí
lastName	string	Apellido.	Sí
document	string	Número del documento de identidad o identificación.	Sí
typeDocumentId	number	Tipo de documento (por ejemplo, 3 puede ser tipo de documento específico).	Sí
dv	number	Dígito verificador del documento.	Sí
emailNotification	string	Email para notificaciones.	Sí
indicativeContact	string	Indicativo telefónico del país (ej. +57 para Colombia).	Sí
phoneContact	string	Número telefónico de contacto sin indicativo.	Sí
categoryId	number	Categoría del tercero (ID).	Sí
dateOfBirth	string	Fecha de nacimiento YYYY-MM-DD	No
addressData	object	Objeto con la información de dirección.	Sí

AdreessData

Parámetro	Tipo	Descripción	Requerido
street	string	Calle y número o referencia	Sí
city	string	Ciudad	Sí
region	string	Código de subdivisión ISO 3166-2. Términos relacionados serían «estado», «provincia», «prefectura», «zona», «subdivisión», etc. (ej. CO-COR)	Sí
postal_code	string	Código postal	Sí
country	string	Código de país (ISO 2 letras)	Sí

JSON

{
  "tradeName": "Juan",
  "legalName": "Pérez",
  "name": "Juan",
  "lastName": "Pérez",
  "document": "1234567890",
  "typeDocumentId": 3,
  "dv": 7,
  "emailNotification": "[email protected]",
  "indicativeContact": "+57",
  "phoneContact": "3004990875",
  "categoryId": 3,
  "dateOfBirth":"1995-12-10",
  "addressData": {
    "street": "calle 35 cr3aw #34-64",
    "city": "Monteria",
    "region": "CO-COR",
    "postalCode": "23001",
    "country": "CO"
  }
}

Respuesta

JSON

{
    "error": 0,
    "code": "ML000",
    "category": "GENERAL",
    "message": "Operación completada con éxito.",
    "data": {
        "uuid": "4c17d508-6588-43f3-9581-bba8badb2812"
    }
}