Crear orden

Crea una orden con un link de pago el cual podrás usar para cobrar con Ualá Bis.

BASE URL:

https://checkout.developers.ar.ua.la/v2/api/checkout

¡Aviso importante! Para usar este endpoint necesitas un token de autorización.

Parámetros

POST https://checkout.developers.ar.ua.la/v2/api/checkout

Headers	Tipo	Descripción
Authorization	Bearer	Token de autorización.

Body json:

{
    "amount": "3005",
    "description": "Descripción de la venta",
    "callback_fail": "https://www.google.com/search?q=failed",
    "callback_success": "https://www.google.com/search?q=success",
    "notification_url": "https://www.notificationurl.com",
    "external_reference": "external_reference"
}

Campo	Tipo	Descripción	Requerido
amount	string	Monto total que será cobrado en el checkout.	Sí
description	string	Descripción de la orden, esta figurará en el checkout.	Sí
callback_fail	string	Link de redirección de pago fallido.	Sí
callback_success	string	Link de redirección de pago exitoso.	Sí
notification_url	string	Link de notificación de estado.	No
external_reference	string	Puedes usar este atributo para enviar referencias de tu orden como puede serlo un ID.	No

Respuestas

Respuesta exitosa

Status 200

{
    "uuid": "613d8938-8dab-41fd-9905-09d52e5312d0",
    "amount": 3005,
    "status": "PENDING",
    "external_reference": "09d52e5312d009d52e5312d09905",
    "links": {
        "checkout_link": "https://uala-checkout.preprod.geopagos.com/orders/613d8938-8dab-41fd-9905-09d52e5312d0",
        "success": "https://www.google.com/search?q=success",
        "failed": "https://www.google.com/search?q=failed"
    }
}

Campo	Tipo	Descripción
uuid	string	Identificador único de la orden generado por Ualá Bis para hacer referencia a la orden.
amount	float	Monto a cobrar.
status	string	Estado de la orden.
external_reference	string	Información extra que puede ser enviada por la integración.
links	object	Objeto compuesto de links.

Campo links:

Campo	Tipo	Descripción
checkout_link	string	Link de pago.
success	string	Link de redirección de pago exitoso.
failed	string	Link de redirección de pago fallido.

Respuestas de error

Campo	Tipo	Descripción
code	string	Código de error.
message	string	Descripción del error.
errors	string array	Errores encontrados

Campos erroneos

{
    "code": "request_error",
    "message": "Invalid request payload.",
    "errors": [
        "Invalid amount format. Amount must have only positive numbers and a single point.",
        "Check notification_url attribute value.",
        "Check callback_fail attribute value.",
        "Check description attribute value.",
        "Provide a valid token with active client_id.",
        "Check external_reference attribute value.",
    ]
}

Casos de uso Webhook