Links de pago

Con Wompi puedes generar un link de pago en segundos usando nuestro dashboard de Comercios, que puedes compartir con tus clientes a través de tus redes sociales, Whatsapp, etc. para comenzar a aceptar pagos en segundos.

Los links de pagos pueden ser creados para ser usados una única vez o múltiples veces; pueden tener una fecha de expiración o no expirar nunca; pueden tener un monto exacto o ser abiertos de manera que el cliente decida la cantidad a pagar.

Generar un link de pago programáticamente

Usando nuestro API, puedes crear un link de pago haciendo una petición HTTP POST al endpoint https://production.wompi.co/v1/payment_links, usando un JSON como el siguiente:

{
  "amount_in_cents": 2500000,
  "currency": "COP",
  "name": "Cachucha",
  "description": "Color negro, tamaño, único",
  "expires_at": "2018-09-20T05:00:00.000Z",
  "image_url": "https://bit.ly/2MBcBGH",
  "redirect_url": "https://www.mitienda.co",
  "single_use": false,
  "sku": "WBXCH1",
  "collect_shipping": false
}

Propiedades obligatorias:

  • amount_in_cents: Valor del producto a vender, en centavos. Por ejemplo para $25.000 pesos, se escribe 2500000. Asegúrate que escribes un número entero, es decir sin usar comillas.
  • currency: Moneda en la que se aceptará el pago. Por ejemplo COP
  • name: Nombre del producto a vender. Por ejemplo "Cachucha"
  • description: Descripción del producto a vender. Por ejemplo: "Color negro, tamaño, único"
  • single_use: Booleano que indica si el link puede ser usado una única vez (true), o múltiples veces (false).
  • collect_shipping: Indica si se quiere recoger información de envío del producto, en caso de querer hacerlo llegar al usuario.

Propiedades opcionales:

  • image_url: URL de la imagen del producto.
  • sku (Opcional): Código único del producto, para el comercio.
  • expires_at: Fecha de expiración del link, a partir de la cual los usuarios no lo pueden usar más. Ejemplo "2018-09-20T05:00:00.000Z". El formato de la fecha es ISO 8601 del tipo **YYYY-MM-DDTHH:mm:ss.sssZ".
  • redirect_url: URL a la cual será redirigido el usuario luego de finalizar el proceso de compra.

No olvides incluir el Header HTTP Authorization

Es necesario incluir el Header HTTP Authorization con el valor Bearer prv_prod_tu_llave, cambiando el texto prv_prod_tu_llave por tu llave privada, que también debe comenzar por prv_prod. Por ejemplo:
Authorization: Bearer prv_prod_Kw4aC0rZVg35LgZdQsn22E4K2Pu28Zx

Luego de hacer una petición POST se obtiene un objeto como el siguiente:

{
  "status": "OK",
  "data": {
    "id": "mNKc3Z",
    "name": "Cachucha",
    "amount_in_cents": 100,
    "currency": "COP",
    "single_use": false,
    "description": "Color negro, tamaño, único",
    "sku": "WBXCH1",
    "expires_at": "2018-10-12 23:25:43 UTC",
    "collect_shipping": false,
    "redirect_url": null,
    "image_url": "https://bit.ly/2MBcBGH",
    "merchant_public_key": "pub_test_a28XA0JxOrPZeWP7a92na2",
    "created_at": "2018-07-01 23:49:45 UTC",
    "updated_at": "2018-07-01 23:49:45 UTC"
  }
}

El "id"obtenido dentro de "data" en esta respuesta será el que debes usar para construir la URL del link de pago

Haz clic aquí para leer la especificación del recurso de Links de pago en nuestro API.

URL de un Link de pago

Para aceptar pagos con un Link de Pago simplemente debes agregar el id del mismo en la siguiente URL:

https://checkout.wompi.co/l/<ID>

Por ejemplo:

https://checkout.wompi.co/l/mNKc3Z

¡Así de fácil puedes aceptar pagos de tus clientes usando un link de pago!

Links de pago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.