Saltar al contenido principal

Cuentas

Una cuenta de pago define cómo se recibe el pago de un pedido. Puedes crear varias cuentas para distintos tipos de pago, por ejemplo, para conectar un sistema de pago o para aceptar pagos en efectivo.

Las cuentas se gestionan en la subsección "Accounts" de la sección "Payments". Las cuentas de pago ya creadas aparecen en la lista general. Debajo está el formulario para crear cuentas de pago nuevas.

Tipos de cuentas de pago​

Actualmente, el sistema ofrece varios tipos de cuentas de pago.

Stripe​

La plataforma OneEntry admite la integración con el sistema de pago Stripe. Elige este tipo si quieres conectar Stripe a tu proyecto. La conexión de Stripe a la plataforma OneEntry se explica en detalle aquí. (se abre en una pestaña nueva)

Midtrans​

La plataforma OneEntry admite la integración con el sistema de pago indonesio Midtrans. La conexión de Midtrans se explica en detalle aquí. (se abre en una pestaña nueva)

Xendit​

La plataforma OneEntry admite la integración con el sistema de pago Xendit. La conexión de Xendit se explica en detalle aquí. (se abre en una pestaña nueva)

Custom​

Usa este tipo de cuenta de pago si quieres trabajar con otro sistema de pago o aceptar pagos en efectivo.

Crear una cuenta de pago​

En el formulario de creación de la cuenta de pago, indica:

  • Nombre: cadena no única.
  • Tipo: valor de la lista desplegable. Solo se puede crear una cuenta de tipo Stripe, una de tipo Midtrans y una de tipo Xendit por proyecto; las cuentas de tipo Custom no tienen límite.
  • Marcador: cadena única.

Cuando hayas rellenado el formulario, haz clic en "Add". Si todos los campos son correctos, la cuenta de pago se crea y aparece en la lista general.

Editar una cuenta de pago​

Selecciona en la lista la cuenta de pago que quieres modificar y haz clic en el ícono de edición Editar.

En el modo de edición puedes cambiar:

  • Nombre
  • Tipo
  • Marcador

En el modo de edición, las cuentas de Stripe, Midtrans y Xendit también tienen ajustes de conexión con el sistema de pago. Se describen en las páginas Stripe (se abre en una pestaña nueva), Midtrans (se abre en una pestaña nueva) y Xendit (se abre en una pestaña nueva).

La pantalla de edición también incluye una tabla con el historial de versiones de la cuenta (columnas Version, Who made the change, Date, Saved data y el ícono Restore Data en la fila de cada versión; mientras no haya guardados, en lugar de la tabla aparece "No data available"). Desde ella puedes consultar los guardados anteriores y restaurar el que necesites. Más información en Historial de versiones.

Los cambios se guardan automáticamente.

Custom parameters for payment API​

Para integrarte de forma flexible con distintos sistemas de pago (por ejemplo, PayPal, Stripe u otros), puedes agregar a la cuenta de pago parámetros personalizados propios de una API concreta.

Estos parámetros se envían como pares clave-valor al iniciar la sesión de pago. Por ejemplo, la API Orders de PayPal suele requerir campos como purchase_units, intent, application_context.return_url o payer.email_address, mientras que Stripe usa otros parámetros, como mode, line_items, etc.

Cómo funciona​

Además de los campos básicos (Nombre, Tipo, Marcador), las cuentas de tipo Stripe, Midtrans y Xendit tienen la tabla Custom parameters for payment API. Las cuentas de tipo Custom no tienen esta tabla. La tabla muestra conjuntos de atributos de la sección Settings → Attributes y permite asociar:

  • Marcador (nombre del parámetro en la API), por ejemplo, purchase_units para PayPal o line_items para Stripe
  • Valor que se insertará al crear el pago

Para establecer un valor, abre la edición del conjunto con el botón Configuración. Luego selecciona el atributo que necesites del conjunto preconfigurado e introduce el valor según el tipo de atributo.

Importante: los conjuntos de atributos y su contenido se configuran por separado y pueden incluir campos de distintos tipos: cadena, número, booleano, JSON, etc.

Ejemplo de uso con PayPal Supongamos que quieres enviar a PayPal los detalles del pedido mediante el campo purchase_units. Creas un conjunto de atributos llamado "PayPal Purchase Unit" y le agregas un atributo items de tipo JSON con una estructura como esta:

    {
      "invoice_id": "90210",
      "amount": {
        "currency_code": "USD",
        "value": "230.00",
        "breakdown": {
          "item_total": {
            "currency_code": "USD",
            "value": "220.00"
          },
          "shipping": {
            "currency_code": "USD",
            "value": "10.00"
          }
        }
      },
      "items": [
        {
          "name": "T-Shirt",
          "description": "Super Fresh Shirt",
          "unit_amount": {
            "currency_code": "USD",
            "value": "20.00"
          },
          "quantity": "1",
          "category": "PHYSICAL_GOODS",
          "sku": "sku01",
          "image_url": "https://example.com/static/images/items/1/tshirt_green.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-1",
          "upc": {
            "type": "UPC-A",
            "code": "123456789012"
          }
        },
        {
          "name": "Shoes",
          "description": "Running, Size 10.5",
          "sku": "sku02",
          "unit_amount": {
            "currency_code": "USD",
            "value": "100.00"
          },
          "quantity": "2",
          "category": "PHYSICAL_GOODS",
          "image_url": "https://example.com/static/images/items/1/shoes_running.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-2",
          "upc": {
            "type": "UPC-A",
            "code": "987654321012"
          }
        }
      ]
}

Luego, en la configuración de la cuenta de pago, vinculas:

Clave: purchase_units Valor: atributo items del conjunto "PayPal Purchase Unit" Al crear el pedido, el sistema inserta automáticamente el valor actual de este atributo en el cuerpo de la solicitud a la API de PayPal.

Otros parámetros de PayPal habituales:

intent: por ejemplo, "CAPTURE" o "AUTHORIZE" application_context.return_url: URL de retorno tras un pago correcto application_context.cancel_url: URL de cancelación del pago

Este mecanismo permite adaptar las integraciones de pago a los requisitos de las API externas.

Exportar datos de una cuenta de pago​

En la fila de cada cuenta, además de los botones para ocultar, modificar y eliminar, hay un botón de exportación de datos (en la versión actual, su texto de ayuda es "Settings"). Abre la ventana de exportación: elige el formato de archivo (csv o xml) y confirma la exportación. El archivo se descargará en el navegador. El botón está disponible para los administradores con permiso de exportación en el módulo de pagos.

Ocultar una cuenta de pago​

Si ya no quieres usar una cuenta de pago pero no puedes eliminarla porque ya se usa en el proyecto, puedes ocultarla.

Para ello, haz clic en el ícono del ojo Ocultar en la cuenta.

Las cuentas de pago ocultas no aparecen como opción al configurar el almacenamiento de pedidos.

Eliminar una cuenta de pago​

Selecciona en la lista la cuenta de pago que quieres eliminar y haz clic en el ícono de eliminación Eliminar.

Confirma la acción en el cuadro de diálogo. La cuenta de pago se eliminará y desaparecerá de la lista general.

Última actualización en