post
https://payment-backend-sandbox.milio.com.co/external-payout/create-provider
Objeto para crear el proveedor
PN: Persona Natural
PJ: Persona Jurídica
{
"name": "Luis H",
"lastName": "hernandez",
"document": "114652258",
"typeDocumentId": 1,
"emailNotification": "[email protected]",
"indicativeContact": "+57",
"phoneContact": "3000000258",
"categoryId": 3,
"dateOfBirth": "1995-12-10",
"addressData": {
"street": "calle 35 cr3aw #34-64",
"city": "Monteria",
"region": "CO-COR",
"postalCode": "23001",
"country": "CO"
}
}
Explicación de cada objeto
| PARÁMETRO | DESCRIPCIÓN | PN | PJ |
|---|---|---|---|
| name | Nombre de pila de la persona. | X | |
| lastName | Apellido de la persona. | X | |
| tradeName | solo cuando el tipo de documento es 3(NIT) Nombre bajo el que se desarrolla la actividad comercial. En este caso, podría ser el nombre de un negocio o emprendimiento. | X | |
| legalName | solo cuando el tipo de documento es 3(NIT) Nombre oficial registrado ante las autoridades. En este caso, podría ser la razón social de una empresa. | X | |
| document | Número de documento del tercero. | X | X |
| typeDocumentId | ID del tipo de documento. | X | X |
| dv | Dígito de verificación del documento (solo si aplica). | X | |
| emailNotification | Dirección de correo electrónico para notificaciones. | X | X |
| indicativeContact | Indicativo de país para el número de teléfono de contacto. | X | X |
| phoneContact | Número de teléfono de contacto del tercero. | X | X |
| categoryId | ID de la categoría del tercero. | X | X |
| dateOfBirth | Fecha de nacimiento del usuario en formato YYYY-MM-DD. Ejemplo: "1995-12-10". Este campo es obligatorio en entornos productivos. | X | X |
| addressData | Información completa de la dirección del usuario. Incluye calle, ciudad, región, código postal y país. Este campo es obligatorio en entornos productivos. | ||
| addressData.street | Dirección o calle principal del domicilio. Ejemplo: "calle 35 cr3aw #34-64". | ||
| addressData.city | Ciudad donde reside el usuario. Ejemplo: "Bogotá". | ||
| addressData.region | Código de región o departamento siguiendo el estándar ISO 3166-2. Ejemplo: "CO-COR" (Córdoba, Colombia). | ||
| addressData.postalCode | Código postal asociado a la dirección. Ejemplo: "23001". | ||
| addressData.country | Código de país en formato ISO 3166-1 alfa-2. Ejemplo: "CO" (Colombia). |
Campos de respuesta
| Campo | Descripción |
|---|---|
error | Indica si hubo un error. 0 significa que no hubo error. |
message | Mensaje descriptivo del resultado de la operación. |
data | Contiene la información del registro guardado. |
data.uuid | UUID del tercero. |
