Braintree es una integración por claves API para tarjetas por banda o tecleadas: copia el Merchant ID, la Public Key y la Private Key del Braintree Control Panel en la tienda. Soporta reembolsos, anulaciones y pagos de facturas en línea, pero no propinas ni un pin pad EMV de mostrador.

Braintree (una empresa de PayPal) se conecta a PHP Point Of Sale con tres valores de API y sin software local. La tarjeta se ingresa por banda o tecleada — el lector de banda USB MagTek 21040108 es el recomendado — así que esta integración conviene a tiendas que teclean tarjetas, cobran por teléfono o cobran facturas en línea. No controla un pin pad EMV de chip y sin contacto de mostrador; si necesitas chip y sin contacto en el mostrador, usa PHP POS Payments u otra integración EMV de elegir un procesador de pagos.

Obtén tus claves API de Braintree

1. Solicita una cuenta de comercio en braintreepayments.com si no tienes una.
2. Inicia sesión en el Braintree Control Panel.
3. Haz clic en Account y luego en My User.
4. Haz clic en API Keys, Tokenization Keys, Encryption Keys.
5. Genera una clave API si aún no tienes una, luego ábrela y copia tres valores:
   • Public Key
   • Private Key
   • Merchant ID (se muestra al hacer clic en la clave API)

Configura la tienda

1. Ve a Tiendas y haz clic en Editar junto a la tienda que cobrará con tarjeta.
2. En la sección Integraciones, marca Activar procesamiento de tarjetas de crédito.
3. Pon el Procesador de Tarjeta de Crédito en Braintree.
4. Pega los tres valores en Id. del comerciante (Merchant ID), Llave pública (Public Key) y Llave privada (Private Key).
5. Haz clic en Guardar.

Eso es toda la configuración — no hay terminal que inicializar. Como el procesamiento se configura por tienda, un negocio con varias sucursales puede usar una cuenta de Braintree distinta (o un procesador totalmente distinto) en cada tienda; mira configurar el procesamiento de tarjetas.

Editar tiendas requiere el permiso del módulo Tiendas en tu cuenta de empleado — mira permisos y plantillas. El procesamiento integrado también requiere que el punto de venta se sirva por HTTPS.

Cobrar un pago

1. Cobra la venta y elige el tipo de pago Tarjeta de crédito.
2. Pasa la tarjeta por el lector MagTek, o teclea el número de tarjeta, la fecha de expiración y el CVV.
3. Braintree aprueba el cargo y el pago se adjunta a la venta.

La integración soporta anulaciones del pago de una venta y reembolsos a la tarjeta del cliente en una devolución. Braintree no admite propinas — ni al cobrar ni después. Como funciona en el navegador sin listener local, también da soporte a pagos en línea sin iniciar sesión — los clientes pueden pagar con tarjeta una factura enviada por correo o un enlace de pago de una venta suspendida. Mira cobrar con tarjeta y facturas y cobros.

Referencia de ajustes

• Activar procesamiento de tarjetas de crédito — interruptor maestro, apagado por defecto.
• Procesador de Tarjeta de Crédito — en Braintree.
• Id. del comerciante — de la página de detalle de la clave API de Braintree.
• Llave pública — del Braintree Control Panel.
• Llave privada — del Braintree Control Panel; trátala como una contraseña.

Preguntas frecuentes

¿Braintree funciona con lector de chip o terminal de pago sin contacto? No. Esta integración es solo banda o entrada tecleada. Para chip EMV y sin contacto en el mostrador, usa PHP POS Payments u otro procesador EMV.

¿Qué lector de tarjetas compro? El lector de banda USB MagTek 21040108 es el modelo recomendado — escribe la banda en los campos de tarjeta como si fuera un teclado, así que no hay nada extra que instalar.

Los pagos fallan con un error de autenticación o autorización. Vuelve a copiar los tres valores del Braintree Control Panel — las causas habituales son una Private Key truncada, claves del entorno sandbox en vez de producción, o valores pegados en los campos equivocados.

¿Los clientes pueden pagar facturas en línea con Braintree? Sí. Con Braintree activo en la tienda, las facturas enviadas por correo y los enlaces de pago se pueden pagar con tarjeta en el navegador sin iniciar sesión. Mira facturas y cobros.

¿Puedo reembolsar a la tarjeta? Sí — ejecuta la devolución o anulación desde la venta original y el dinero vuelve a la misma tarjeta a través de Braintree. Mira cobrar con tarjeta.

¿Pueden distintas tiendas usar distintas cuentas de Braintree? Sí. Las claves viven en cada tienda, así que cada sucursal puede tener su propia cuenta de comercio.