Crear cliente

Desarrollando

POST

/api/v1/transactions/orders/customers/create

Endpoint que permite crear clientes para empresas de logisticas

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200Éxito

application/json

Bodyapplication/json

🟠400Solicitud Incorrecta

🟠401No Autorizado

🟠404Registro No Encontrado

🔴500Error del Servidor

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location '/api/v1/transactions/orders/customers/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "data": {
    "name": "Juan Pérez",
    "firstName": "Juan",
    "middleName": "Carlos",
    "lastName": "Pérez",
    "secondLastName": "Gómez",
    "docType": "CC",
    "docNumber": 100200300,
    "cellphone": "3001234567",
    "email": "juan@example.com",
    "address": "Calle 1 # 2-3",
    "gender": "M",
    "birthCityName": "Bogotá",
    "cityId": 1,
    "birthDate": "1990-01-01",
    "docExpDate": "2030-01-01",
    "resourceKey": "res-key-123",
    "confirmUrl": "https://merchant.com/confirm"
  }
}'

Ejemplo de Respuesta

200 - Éxito

{
    "statusCode": 200,
    "message": "Exitoso",
    "data": {
        "Resource": {
            "key": "305103",
            "type": "qr",
            "message": 200,
            "qr": "data:image/webp;base64,UklGRoxSAQB..."
        },
        "Costs": [
            {
                "id": 141,
                "min": 0,
                "max": 99999999,
                "type": "fixed",
                "cost": 500,
                "costProvider": 250,
                "costTypeProvider": "fixed"
            }
        ],
        "isManual": 0
    },
    "_channel": "web"
}

Modificado en 2026-07-03 18:13:30

Webhook

Crear planilla (pendiente de cobro)