Cost+Docs

Pagos con un clic (CIT)

Habilita pagos con un clic iniciados por el cliente con tokenizacion de tarjeta

Los pagos con un clic permiten a los clientes recurrentes pagar con un solo clic usando una tarjeta almacenada previamente. Este es un flujo de transaccion iniciada por el cliente (CIT) que utiliza tokenizacion.

Como funciona

El flujo de pago con un clic tiene dos fases:

  1. Primer pago — El cliente paga normalmente y solicitas un token para uso futuro
  2. Pagos posteriores — Usas el token almacenado para cobrar al cliente con un clic

Fase 1: Primer pago (tokenizacion)

Crea un pedido con one_click_type: "first" en la transaccion para solicitar la tokenizacion:

POST /v1/orders/
{
  "merchant_order_id": "first-order",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "one_click_type": "first"
    }
  ]
}

Despues de un pago exitoso, la respuesta incluira un vault_token y first_transaction_id en el objeto de transaccion. Almacena estos valores — los necesitaras para futuros pagos con un clic.

Response (transaction object)
{
  "payment_method": "credit-card",
  "payment_method_details": {
    "vault_token": "abc123-stored-token",
    "first_authorised_transaction_id": "txn_def456"
  }
}

Fase 2: Pago con un clic

Usa el vault_token almacenado para crear un pago con un clic:

POST /v1/orders/
{
  "merchant_order_id": "oneclick-order",
  "currency": "EUR",
  "amount": 995,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "one_click_type": "one-click",
      "vault_token": "{vault_token from phase 1}"
    }
  ]
}

Puedes usar tanto vault_token como first_transaction_id para referenciar la tarjeta almacenada. Ambos funcionan indistintamente.

Gestion del CVC

El CVC es opcional para pagos con un clic. Si deseas recopilar el CVC para seguridad adicional, incluyelo en la transaccion:

{
  "payment_method": "credit-card",
  "one_click_type": "one-click",
  "vault_token": "{vault_token}",
  "cvc": "123"
}

Los pagos con un clic son iniciados por el cliente (CIT). Para cobros recurrentes iniciados por el comerciante (MIT), consulta Pagos recurrentes.

Endpoints relacionados

  • Crear pedido — usa one_click_type en la transaccion para iniciar la tokenizacion o pagos con un clic

On this page