Configura el enlace de pago

Esta guía cubre dos configuraciones que realizas antes o durante la creación de un enlace de pago: cargar imágenes para productos y configurar cuotas por país y marca de tarjeta.

Cómo funciona

Esta guía cubre dos configuraciones independientes que realizas antes o durante la creación de un enlace de pago: cargar imágenes para productos y configurar cuotas por país y marca de tarjeta. Características clave:

• Imágenes de productos — carga una imagen primero para obtener un image_id, y luego haz referencia a ese image_id en el arreglo products al crear o actualizar el enlace. De forma opcional, puedes recuperar el contenido binario de una imagen por su identificador. Los formatos aceptados son PNG y JPEG, hasta 250 MB.
• Configuraciones comerciales — los comercios pueden habilitar o deshabilitar operaciones de pago específicas (crédito, débito, Boleto, PIX y otras), lo que determina los métodos que se muestran en el checkout.
• Cuotas (solo crédito) — las cuotas se configuran por marca de tarjeta de crédito, dentro de payment.credit.brands[].supported_installments; null o su ausencia significa pago único. Los métodos basados en tarjeta (credit, debit) usan un arreglo brands[] para la configuración por marca, mientras que otros métodos usan solo el toggle { "enabled": true }.
• Cómo se relacionan los campos de cuotas — installments enumera las cantidades válidas, installments_with_interest marca cuáles de esas cantidades tienen interés, e installments_with_increase asigna una tasa porcentual a grupos de cuotas.
• Esquemas específicos por región — el schema determina las reglas de cuotas y varía según el país (por ejemplo, plan_lojista / plan_emissor en Brasil, plan_emisor / cuota_comercio en Chile y plan_prosa en México).

La configuración de imágenes de productos sigue una secuencia breve:

Antes de empezar

• Obtén un token de acceso. Consulta Autenticación.

Imágenes de productos

Para mostrar una imagen en un producto del enlace de pago, carga la imagen primero. Usa el image_id devuelto en el campo image_id del objeto products al crear o actualizar el enlace.

Paso 1 - Carga la imagen

Reglas de completado de campos:

• Content-Type: multipart/form-data
• Formatos aceptados: image/png, image/jpeg
• Tamaño máximo: 250 MB

Campos obligatorios

Ejemplo de solicitud

curl https://api-sbx.pre.globalgetnet.com/dpy/payment-link/v1/payment-links/products/images \
  --request POST \
  --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file='

Ejemplo de respuesta

{
    "image_id": "6697e354-ab4a-11eb-bcbc-0242ac130002",
    "original_name": "product-photo.png",
    "mime_type": "image/png",
    "upload_at": "2026-06-10T14:30:00.000Z"
}

Paso 2 — Haz referencia a la imagen en un producto

Usa el image_id devuelto al construir el arreglo products en la creación o actualización del enlace:

"products": [
   {
      "product_type": "physical_goods",
      "title": "Camiseta Oficial Getnet",
      "amount": 9990,
      "quantity": 1,
      "image_id": "6697e354-ab4a-11eb-bcbc-0242ac130002"
   }
]

Paso 3 (opcional) — Recupera la imagen

Usa este endpoint para recuperar el contenido binario de una imagen por su identificador.

Ejemplo de solicitud

curl https://api-sbx.pre.globalgetnet.com/dpy/payment-link/v1/payment-links/products/images/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...'

La respuesta 200 OK devuelve el contenido binario con el Content-Type correspondiente (image/png o image/jpeg).

Ejemplo de respuesta

{
  "type": "string",
  "contentMediaType": "application/octet-stream"
}

Configuraciones comerciales

Los comercios pueden configurar su enlace de pago de forma opcional, habilitando o deshabilitando operaciones de pago específicas. Estos ajustes determinan qué métodos de pago, como tarjetas de crédito, tarjetas de débito, Boleto (bank slip) o PIX (pago instantáneo), se muestran durante el proceso de checkout.

Cuotas

Las cuotas se configuran dentro de cada marca de tarjeta de crédito, en payment.credit.brands[].supported_installments. Cada entrada es un objeto InstallmentPlan que representa un esquema de cuotas ofrecido por el adquirente o el emisor.

Los métodos basados en tarjeta (credit, debit) tienen un arreglo brands[] para la configuración por marca. Otros métodos usan solo el toggle { "enabled": true }. Las cuotas aplican solo a crédito; null o su ausencia significa pago único.

Para entender las reglas de cuotas de cada país, consulta Reglas y disponibilidad de cuotas

Campos obligatorios

Campos opcionales

Ejemplo de solicitud

curl https://api-sbx.pre.globalgetnet.com/dpy/payment-link/v1/payment-links/business-configurations \
  --request POST \
  --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'Content-Type: application/json' \
  --data '{
  "expiration": "2026-12-31T23:59:59",
  "max_orders": 100,
  "request_delivery_address": false,
  "payment": {
    "credit": {
      "enabled": true,
      "brands": [
        {
          "enabled": true,
          "brand": "VISA",
          "currencies": [
            "BRL"
          ],
          "threeds": true,
          "supported_installments": [
            {
              "schema": "plan_lojista",
              "schema_name": "Plan Lojista",
              "installments": [2,3,4,5,6,7,8,9,10,11,12],
              "installments_with_interest": [6,9,12]
            }
          ]
        }
      ]
    },
    "debit": {
      "enabled": true,
      "brands": [
        {
          "enabled": true,
          "brand": "VISA",
          "currencies": [
            "BRL"
          ],
          "threeds": true
        }
      ]
    },
    "bankslip": {
      "enabled": true
    },
    "instant_payment": {
      "enabled": true
    },
    "google_pay": {
      "enabled": false
    },
    "apple_pay": {
      "enabled": false
  },
  "currency": "BRL"
}'

Cómo se relacionan los campos

• installments enumera las cantidades de cuotas válidas. Por ejemplo, [2, 3, 6, 12] permite al comprador pagar en 2, 3, 6 o 12 cuotas.

• installments_with_interest indica cuáles de esas cuotas tienen interés. Si installments = [2,3,6,12] e installments_with_interest = [6,12], entonces 2 y 3 cuotas no tienen interés, mientras que 6 y 12 sí lo tienen.

• installments_with_increase ofrece precios basados en tasas: cada entrada agrupa cuotas y les asigna una tasa porcentual.

Objeto InstallmentsWithIncrease

Ejemplo:

"installments_with_increase": [
  { "installments": [3, 6], "rate": 1.5 },
  { "installments": [9, 12], "rate": 2.99 }
]

En este caso, 3 y 6 cuotas tienen un incremento del 1.5%, y 9 y 12 cuotas tienen un incremento del 2.99%.

Esquemas regionales

Ejemplos por país

Brasil — plan_lojista + plan_emissor

{
    "enabled": true,
    "brand": "VISA",
    "currencies": ["BRL"],
    "threeds": true,
    "supported_installments": [
       {
          "schema": "plan_lojista",
          "schema_name": "Plan Lojista",
          "installments": [2,3,4,5,6,7,8,9,10,11,12],
          "installments_with_interest": [6,9,12]
       },
       {
          "schema": "plan_emissor",
          "schema_name": "Plan Emissor",
          "installments": [2,3,4,5,6],
          "installments_with_interest": []
       }
    ]
}

Chile - plan_emisor + cuota_comercio

{
    "enabled": true,
    "brand": "VISA",
    "currencies": ["CLP"],
    "threeds": true,
    "supported_installments": [
      {
        "schema": "plan_emisor",
        "schema_name": "Plan Emisor",
        "installments": [2, 3, 4, 5, 6],
        "installments_with_interest": [4, 5, 6]
      },
      {
        "schema": "cuota_comercio",
        "schema_name": "Cuota Comercio",
        "installments": [2, 3, 6, 9, 12],
        "installments_with_interest": [6, 9, 12]
      }
    ]
  }

México — plan_prosa

{
    "enabled": true,
    "brand": "VISA",
    "currencies": ["MXN"],
    "threeds": true,
    "supported_installments": [
      { "schema": "plan_prosa", "schema_name": "Plan Prosa", "installments": [3,6,9,12], "installments_with_interest": [3,6,9,12] }
    ]
}

Ejemplo con installments_with_increase

{
    "enabled": true,
    "brand": "MASTERCARD",
    "currencies": ["BRL"],
    "threeds": true,
    "supported_installments": [
       {
          "schema": "plan_lojista",
          "schema_name": "Plan Lojista",
          "installments": [2,3,4,5,6,7,8,9,10,11,12],
          "installments_with_interest": [6,9,12],
          "installments_with_increase": [
             { "installments": [2,3,4,5,6], "rate": 1.5 },
             { "installments": [7,8,9,10,11,12], "rate": 2.99 }
          ],
          "single_increase_rate": false
       }
    ]
}

Próximos pasos

• Cómo crear un enlace de pago </content>