Crear un pago

Este documento aplica a los siguientes países:

Esta guía te muestra cómo procesar una transacción de pago completa en un solo paso mediante la API de Getnet Web Checkout. El flujo implica la captura directa del pago sin una autorización previa.

Cómo funciona

Usa el pago en un solo paso cuando quieras capturar el pago directamente en un paso, sin una autorización previa. Características clave:

• Captura en un solo paso — la transacción se captura directamente; no hay un paso de autorización independiente.
• Mismo payment intent — creas el payment intent mediante el endpoint POST /payment-intent, el mismo que se usa para los demás métodos.
• Requisitos de campos por región — los campos obligatorios varían según el país (moneda, tipo de documento, código de país), y Uruguay requiere el objeto additional_data con las tasas de impuestos y el código de regulación regional para el cumplimiento de SEP.
• Configuraciones opcionales — puedes definir 3DS, las URLs de redirección (success_url / error_url) y la expiración del intent (expires_at) en la solicitud; cuando se proporcionan, las URLs de redirección anulan la configuración técnica del vendedor.

El flujo involucra al comprador, la página de Checkout y la API de Getnet WebCheckout:

Requisitos

Antes de seguir los pasos, necesitas:

• Configurar tu Web Checkout mediante Portal o mediante API (dependiendo de tu ubicación).
• Generar tu token siguiendo el documento de Authentication.

Proceso de pago en un solo paso

Esta sección te guía a través del proceso de creación de una transacción de pago en un solo paso con la API de Getnet Web Checkout. Aprenderás a capturar el pago directamente en un solo paso.

Campos obligatorios

Campos condicionales (solo Uruguay)

Campos opcionales

Valores de los campos

Reglas para completar los campos:

• El campo expires_at acepta un valor de duración (por ejemplo, 15m, 2h, 7d o 1d12h30m). Esta duración se aplica sin importar la zona horaria del merchant. La marca de tiempo de expiración que devuelve la API siempre tiene formato GMT+0 (UTC). Si no se proporciona ningún valor, el payment intent no expira.
• Cuando se proporcionan success_url y error_url en la solicitud del payment intent, estos anulan el valor configurado en la configuración técnica del vendedor.
• Uruguay: los vendedores pueden crear payment intents en UYU (peso uruguayo) o en USD. Al pagar en UYU, el objeto additional_data es obligatorio y debe incluir additional_data.rates.key con la clave de tasa IVA y el regional_regulation_code para el cumplimiento de SEP.
• Argentina: card_verification y preauthorization no están disponibles para Argentina.

Ejemplo de solicitud:

{
  "mode": "instant",
  "order_id": "ORDER_UY_97531",
  "configurations": {
    "3ds": true,
    "preauthorization": false,
    "card_verification": false,
    "success_url": "https://www.mystore.com/checkout/success",
    "error_url": "https://www.mystore.com/checkout/error"
  },
  "payment": {
    "currency": "UYU",
    "amount": 120000
  },
  "product": [
    {
      "product_type": "service",
      "title": "Curso de inglés online",
      "description": "Curso completo de 6 meses",
      "value": 120000,
      "quantity": 1
    }
  ],
  "customer": {
    "customer_id": "12345678912",
    "first_name": "Laura",
    "last_name": "Fernández Rodríguez",
    "name": "Laura Fernández Rodríguez",
    "email": "laura.fernandez@example.com.uy",
    "document_type": "ci",
    "document_number": "45678912",
    "phone_number": "59899123456",
    "gender": "Female",
    "checked_email": true,
    "billing_address": {
      "street": "Av. 18 de Julio",
      "number": "1234",
      "complement": "Apto 601",
      "district": "Centro",
      "city": "Montevideo",
      "state": "Montevideo",
      "country": "UY",
      "postal_code": "11200",
      "reference": "Entre Río Branco y Convención"
    }
  },
  "shipping": {
    "first_name": "Laura",
    "last_name": "Fernández Rodríguez",
    "name": "Laura Fernández Rodríguez",
    "phone_number": "59899123456",
    "shipping_amount": 0,
    "address": {
      "street": "Av. 18 de Julio",
      "number": "1234",
      "complement": "Apto 601",
      "district": "Centro",
      "city": "Montevideo",
      "state": "Montevideo",
      "country": "UY",
      "postal_code": "11200",
      "reference": "Entre Río Branco y Convención"
    }
  },
  "pickup_store": false,
  "shipping_method": "UES",
  "soft_descriptor": "Tienda UY",
  "additional_data": {
    "rates": [
      {
        "key": "IVA",
        "value": 22
      }
    ],
    "regional_regulation_code": ["17934"]
  },
  "expires_at": "1h"
}

Ejemplo de respuesta 200

{
  "payment_intent_id": "ee0b7dd5-92da-4ef4-ad3b-0ba369ad0efe"
}

Próximos pasos

Ahora que creaste correctamente un pago en un solo paso, puedes explorar más pagos de la API de Getnet Web Checkout:

• Aprende cómo crear un pago con preautorización.
• Aprende cómo crear un pago con verificación de tarjeta.
• Aprende cómo crear un pago con 3DS.