Crea tu primera orden

🛍️ En esta sección aprenderás como crear tu primera orden de compra.

1. Autenticación

La autenticación para el API es realizada vía HTTPS Basic Auth, en la cual tu API key toma el lugar de tu nombre de usuario. No se requiere una contraseña. El API key de sandbox es el que tiene el prefijo sk_test_ y el de producción sk_live_ .

Todas las peticiones deben ser hechas mediante HTTPS . Las peticiones realizadas sobre HTTP plano o sin autenticación no serán exitosas.

2. Versión

Todos las peticiones HTTP necesitan tener la versión del API a utilizar en el encabezado de la petición, de lo contrario, no se podrá obtener una respuesta exitosa. En este momento utilizaremos la version más reciente v1

3. Petición

Para que realices tu primera orden, copia el código mostrado abajo y cambia el API key por el tuyo:

                                        
                                            curl "https://sandbox-api.kredito.io/orders" \
    -u sk_test_f1e054af28f14e6c9be48ed323ee4b78: \
    -H "Api-Version: v1" \
    --data-raw '{
        "amount":1000.00,
        "success_url":"https://domain.com/success",
        "failure_url":"https://domain.com/fail"
    }'

Una vez que hayas realizado la petición, deberás recibir una respuesta con el siguiente formato:

                                        
                                            {
        "uuid": "ord-30b8e315d8b442a1b3a43216a13fbb0a",
        "reference": "301117",
        "subtotal": 970,
        "fee": 30,
        "total": 1000,
        "currency": "MXN",
        "status": "created",
        "internal_status": "created",
        "expires_at": "2020-07-30T22:48:18.000Z",
        "down_payment": null,
        "opening_fee": 50,
        "credit": null,
        "apr": 0,
        "payment_type": null,
        "created_at": "2020-07-30T18:48:18.000Z",
        "redirect_url": "https://sandbox-checkout.kredito.io/ord-30b8e315d8b442a1b3a43216a13fbb0a/inicio",
        "success_url": "https://domain.com/success",
        "failure_url": "https://domain.com/fail",
        "items": []
    }

Una vez creada la orden, será necesario redirigir al cliente al url que viene en la respuesta como redirect_url para que pueda continuar con el flujo de pago y poder completar la información de la orden.

3. Más información

Si requieres consultar más detalles sobre los campos y esquemas utilizados en el API, consulta nuestra Referencia API.

Siguiente