SQUARE TERMINAL API

Connectez votre application à Square Terminal pour accepter les paiements en magasin.

Que vous conceviez une application de PDV ou un système de gestion commerciale, connectez votre application à Square Terminal, l’appareil à carte complet par Square. Les développeurs peuvent offrir des paiements en magasin sur chaque plateforme via Square


Étape 1 : Jumelez votre application avec Square Terminal.

Appelez l’API Appareils pour générer un code d’appareil et l’afficher pour votre utilisateur. Une fois que votre utilisateur s’est connecté à Terminal en utilisant le code, un événement webhook (qui contient device_id) vous informe que l’appareil est prêt à recevoir une demande de paiement de la part de votre système.

body = {
idempotency_key: '{{RANDOM_STRING}}',
 device_code: {
   name: 'Counter 1',
   product_type: 'TERMINAL_API',
   location_id: 'B5E4484SHHNYH',
 }
}

client.devices.create_device_code(body: body)

Étape 2 : Envoyez le montant du paiement à partir de votre application vers Terminal.

Appelez Créer un paiement avec Square Terminal pour le montant du paiement. L’appareil invitera alors l’acheteur à payer.

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)

Étape 3 : Finalisez la vente dans votre application.

Une fois le paiement effectué, des webhooks vous signalent que vous pouvez conclure la vente.

{
  "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"
      }
    }
  }
}

Pourquoi Square Terminal ?

Square Terminal est votre appareil tout-en-un pour les paiements par carte et pour les reçus. Square l’a conçu de sorte qu’il offre une façon sécurisée, fiable et totalement équitable d’encaisser des paiements.

Laissez Square gérer les paiements pour vous.

Pour en savoir plus, consultez la documentation sur l’API du Terminal.