Home

3. Obtention URL 1click (Appel backend vers Oyst)

Votre backend appel Oyst pour récupérer le contenu de la modale d'achat en 1click. Oyst retournera l'url à charger par la modale d'achat en 1click.

L'appel à Oyst se fait sur le endpoint : /v2/orders/authorize

Pour obtenir l'url, vous devez passer à minima les objets suivants en paramètre :

  • Votre clé API (en header Authorization)
  • Le produit
  • L'url sur laquelle Oyst vous notifie des nouvelles commandes
POST /oneclick/v2/orders/authorize HTTP/1.1
Host: api.sandbox.oyst.eu
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache

{  
   "product":{  
      "amount_including_taxes":{  
         "value":999,
         "currency":"EUR"
      },
      "images":["https://upload.wikimedia.org/wikipedia/commons/thumb/a/a6/Rubik%27s_cube.svg/langfr-480px-Rubik%27s_cube.svg.png"],
      "reference":"rubikscube",
      "title":"Rubiks Cube 3x3"
   },
   "notifications": {
      "url": "http://www.your_notification_url.com"
   }
}

🚧

Tous les montants envoyés et renvoyés par Oyst sont en centimes

Dans l'exemple ci dessus, le champ "value" est renseigné en centimes d'euros.

Format de la réponse de Oyst :

{
	url: "https://1click.oyst.com/pay?token=03f329983b86f7d9a9f5fef85305880101d5e302afafa20154d094b229f75773" 
}

Cet objet contient l'url du contenu de la modale d'achat en 1click. Vous devez retourner cet objet tel quel à votre front. La modale d'achat s'ouvrira automatiquement.

Vous devez obtenir le résultat suivant.

577