Terminal de paiement

Commander un terminal de paiement

Prérequis

Votre société doit être dans un statut validated ou available afin de pouvoir commander un terminal de paiement.

Vous devrez également avoir renseigner l'adresse de livraison via le champ shipping-address lors d'un POST|PATCH /company.

Commander

Utiliser l'endpoint POST /payment-terminal?company=<comp>&account=<acct>&name=<name> pour commander un terminal de paiement :

import requests

url = "https://api-partners.stancer.com/api/partners/payment-terminal?company=comp_1b5u13neReekPsT9Tp8onW7n&account=acct_ncjpK8mjnaCtrE3qLsHIaI9d&name=tpe1"

payload = {}
headers = {}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.json())

Réponse :

{
  "id": "term_vSV6TfDW6p1FMPPpxhBxEuhA",
  "name": "tpe1",
  "status": "pendingOrder"
}

Obtenir la liste des terminaux de paiement

Utiliser l'endpoint GET /payment-terminal?company=<comp>&account=<acct> pour obtenir la liste des terminaux de paiement :

import requests

url = "https://api-partners.stancer.com/api/partners/payment-terminal?company=comp_1b5u13neReekPsT9Tp8onW7n&account=acct_ncjpK8mjnaCtrE3qLsHIaI9d&name=tpe1"

payload = {}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.json())

Réponse :

[
  {
    "carrier-name": "DHL",
    "id": "term_vSV6TfDW6p1FMPPpxhBxEuhA",
    "name": "tpe1",
    "status": "shipped",
    "tracking-url": "https://www.dhl.com/fr/home/tracking.html?tracking-id=4456653377&submit=1"
  }
]

Une fois la commande expédiée, vous aurez accès au nom du transporteur (carrier-name) et à une url de suivi (tracking-url).

Annuler la commande d'un terminal de paiement

Vous pouvez annuler la commande uniqument si son statut est en pendingOrder.

Utiliser l'endpoint POST /cancel-payment-terminal-order?company=<comp>&account=<acct>&payment-terminal=<term> pour annuler la commande d'un terminal de paiement :

import requests

url = "https://api-partners.stancer.com/api/partners/cancel-payment-terminal-order?company=comp_1b5u13neReekPsT9Tp8onW7n&account=acct_ncjpK8mjnaCtrE3qLsHIaI9d&payment-terminal=term_rEQA6RgblYJ8WlnCrHEtxuM0"

payload = {}
headers = {}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.json())

Status

Voici la liste des statuts d'un terminal de paiement :

Code	Description
pendingOrder	Commande en attente.
orderCancelled	Commande annulée.
orderInProgress	Commande en cours.
shipped	Commande expédiée.
delivred	Commande livrée.
activated	Terminal de paiement activé.
posLostByCarrier	Terminal de paiement perdu par le transporteur.
pendingPosReturn	L'utilisateur doit renvoyer le terminal de paiement. En attente du retour du terminal de paiement.
poskeptByMerchant	Terminal de paiement gardé par l'utilisateur après une résiliation.
posReturned	Terminal de paiement retourné à Stancer.
deactivated	Terminal de paiement désactivé.