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.


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: 'EUR'
   },
   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.

Una vez el pago se haga correctamente, recibirás una 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": "EUR"
        },
        "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.

Square se encarga de los pagos por ti

Si quieres más información, consulta la Documentación de la API de Square Terminal.