API DE SQUARE TERMINAL

Conecta tu aplicación a Square Terminal para hacer pagos en persona

Con Square Terminal, que admite todo tipo de tarjetas, puedes conectar tu aplicación de forma inalámbrica para crear un TPV o un sistema de gestión empresarial. Ahora los desarrolladores de todas las plataformas pueden ofrecer pagos en persona con Square.

Empezar

Paso 1: Vincula tu aplicación con Square Terminal

Haz una llamada a la API para dispositivos para generar un código de dispositivo y mostrárselo al usuario. Cuando este inicie sesión en Square Terminal con el código, un evento de webhook (que contiene el «device_id») te notificará que el dispositivo está listo para recibir una solicitud de pago desde tu sistema.

body = { idempotency_key: '{{RANDOM_STRING}}', device_code: { name: 'Counter 1', product_type: 'TERMINAL_API', location_id: 'B5E4484SHHNYH', } } client.devices.create_device_code(body: body)

Paso 2: Envía un importe de pago desde la aplicación a Square Terminal

Utiliza la función Crear un proceso de pago en Terminal con un importe determinado y el dispositivo solicitará el pago al comprador.

body = { idempotency_key: '{{RANDOM_STRING}}', checkout: { amount_money: { amount: 2610, currency: 'USD' }, reference_id: 'id123', note: 'A brief note', device_options: { device_id: '{{DEVICE_ID}}' } } } client.terminal.create_terminal_checkout(body: body)

Paso 3: Cierra la venta en la aplicación

Cuando el pago se haya completado, recibirás la notificación a través de webhooks para que puedas cerrar la venta.

{ "merchant_id": "7NZR...NPC", "type": "terminal.checkout.updated", "event_id": "7229a692-def5-4a7e-b4f3-80638aa2f24d", "created_at": "2020-04-10T14:43:55.262Z", "data": { "type": "checkout.event", "id": "dhgENdnFOPXqO", "object": { "checkout": { "amount_money": { "amount": 2610, "currency": "USD" }, "app_id": "sq0idp-734M...nm6g", "created_at": "2020-04-10T14:43:55.262Z", "deadline_duration": "PT5M", "device_options": { "device_id": "{{DEVICE_ID}}", "skip_receipt_screen": false, "tip_settings": { "allow_tipping": false } }, "id": "dhgENdnFOPXqO", "note": "A brief note", "payment_ids": [ "dgzrZT...PouaB" ], "reference_id": "id123", "status": "COMPLETED", "updated_at": "2020-04-10T14:44:06.039Z" } } } }

¿Por qué elegir Square Terminal?

Square Terminal es un datáfono todo en uno que te sirve para aceptar pagos y emitir recibos. Está creado por Square, por lo que es seguro, fiable y te proporciona una manera mucho más justa de recibir tu dinero.