Lors de l'appel à /v2/orders/authorize vous pouvez saisir des informations contextuelles dans le champ context. Ces informations vous seront retournées avec la commande lorsque l'achat aura été effectué.
Par exemple : L'utilisateur 'toto25' est loggué sur votre site au moment du clic sur le bouton. Vous pouvez passer son identifiant unique dans le contexte. Cet identifiant vous sera retourné à la récupération de la commande. Vous pourrez ainsi lier la commande à son compte dans votre base de donnée.
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":{...},
"notifications": {
"url": "http://www.your_notification_url.com"
},
"context":{
"id": "context_id",
"user_login":"toto25"
}
}
L'attribut id est obligatoire et correspond à l'identifiant de votre contexte. C'est à vous de le définir. Cet id vous est propre, il n'y pas pas de risque de collision avec l'id de contexte d'un autre marchand. Vous pourrez ainsi récupérer les informations de commande liées à ce contexte à tout moment en appelant le point d'entrée suivant :
/order/v2/orders/context/context_id
Format de la réponse :
{
"orders": [
{
"context": {
"id": "context_id",
"user_login": "toto25"
},
"created_at": "2017-08-30T15:06:17.847Z",
"current_status_updated_at": null,
"current_status": "waiting",
"delay_to_notify": 2,
"fees": null,
"id": "bc5fd46c-0fd2-4c1c-b4d0-55d4de315b09",
"items": [...],
"transaction": null,
"updated_at": "2017-08-30T15:06:17.933Z",
"user": {
"id": "0790b9a0-6e25-11e7-8690-9f9242ee9c44",
"email": "[email protected]",
"phone": "+33652513755",
"address": {
"city": "Paris",
"label": "Travail",
"street": "4 rue du caire, Societe OYST - 2eme etage",
"country": "FR",
"postcode": "75002",
"last_name": "MAUMENE",
"first_name": "Jonas",
"company_name": "Societe OYST - 2eme étage",
"complementary": "4 rue du caire"
},
"language": "en",
"last_name": "MAUMENE",
"first_name": "Jonas"
}
}
]
}