Skip to main content

16. Liga de Pago - API

16 Introducción​

El servicio de liga de pago también está disponible a través de nuestra API REST, permitiendo la integración directa con sus sistemas. Para utilizarla, solo necesita las credenciales de autenticación proporcionadas por Zigu y poder realizar peticiones HTTP desde su aplicación.

16.2 Autenticación​

Obtener token de autenticación​

Vamos a necesitar el correo electrónico y contraseña de la cuenta de Zigu.

Para obtener el token de autenticación, se debe hacer una petición HTTP POST a la siguiente URL:

https://webserver.zigu.mx/api/v2/auth

Con los siguientes encabezados:

Content-Type: application/json

Con los siguientes parámetros:

  • correo: El correo electrónico de la cuenta de Zigu.
  • contrasena: La contraseña de la cuenta de Zigu.

Y el resultado será muy similar al siguiente:

{
    "payload": {
        "token": "eyJhbGciOiJ...5fJ-ab3e7ytpV8OIAFVNdTC"
    }
}

16.3 Crear liga de pago​

Para crear una liga de pago a través de la API, necesitamos hacer una petición HTTP POST a la siguiente URL:

https://webserver.zigu.mx/api/v2/payment-link

El token de autenticación debe incluirse en el encabezado HTTP de la petición de la siguiente manera:

Authorization: BMToken <token>
Content-Type: application/json

Con los siguientes parámetros:

  • offerAmount: El monto de la liga de pago (ejemplo: 99.90).
  • offerName: El nombre de la liga de pago (ejemplo: "Producto #1").
  • offerDescription: La descripción de la liga de pago (ejemplo: "Detalle del producto").
  • ttl: Tiempo de vida de la liga en días (ejemplo: 1).
  • threeDs: Habilitar autenticación 3D Secure (ejemplo: true).
  • installments: Número de meses sin intereses (ejemplo: 0).

Y el resultado será muy similar al siguiente:

{
    "paymentLink": {
        "url": "https://api.zigu.mx/paymentpage/load/...",
        "offerNameUri": "Producto #1",
        "offerDescriptionUri": "Detalle del producto",
        "offerTtl": "14012025154539",
        "offerKey": "8D3F7A2E9C1B5840D6R4N2P9M7K5J3H1G4F8Q6W",
        "preOfferKey": "150.5ProductoA D220230915163742XYnull",
        "xtlOrderId": "PL100",
        "currency": "MXN",
        "productType": 6,
        "rebillMetric": "D",
        "rebillPeriod": 1
    },
    "id": "xn8mq92krvhp4163lsyztdw5j"
}

16.5 Ingresar a una liga de pago​

Para ver la liga de pago previamente creada, es necesario entrar al portal de zigu y verla en la sección de ligas de pago.

Para ingresar a una liga de pago es necesario presionar el boton amarillo de la tabla como se muestra en la imágen.

15.5

El botón debera ser el correspondiente del renglon de la liga de pago indicada.

Esta acción abrirá la liga de pago en una nueva pestaña del navegador.

Esta URL la pueden compartir por cualquier medio que gusten, por ejemplo:

Correo electrónico, whatsapp, sms, entre otros.