Créer une commande

Dans cette étape, nous allons voir comment créer une commande. Il est impératif d'avoir assimilé l'étape précédente.

N'envoyez que les commandes qui concernent Cherry Checkout (pour lesquelles, il y'a une participation).

Requète :

{
  "trackId": "ODR-5736",
  "orderPrice": 85.90,
  "cherryPrice": 2,
  "currency": "eur",
  "status": "validated",
  "customer": {
    "firstname": "Michael",
    "lastname": "Jackson",
    "email": "kingofpop@mjcompany.com",
    "birthday": "1958-08-29",
    "gender": "m",
    "address": "55 rue de la république",
    "zipCode": "75000",
    "city": "Paris",
    "country": "France"
  }
}
		
Order
trackId* string L'ID de la commande doit être unique pour chaque commande.
orderPrice* float Le prix total de la commande, en excluant le montant de la participation.
cherryPrice integer Le montant de la participation souhaité par le client.
currency* string La devise de la commande.
Valeurs acceptées: 'chf', 'eur'
status string Le statut de la commande.
Valeurs acceptées: 'validated', 'canceled'
customer* Customer Les informations du client.
Customer
firstname* string Le prénom du client.
lastname* string Le nom du client.
email* string L'adresse e-mail du client.
birthday string La date de naissance du client. Format attendu: 'YYYY-MM-DD'
gender string Le genre du client.
Valeurs acceptées: 'm', 'f'
address string L'adresse du client, avec le numéro, ainsi que le type et le nom de la rue.
zipCode string Le code postal du client
city string La ville du client
country string Le pays du client

Réponse :

{
  "trackId": "ODR-5736",
  "orderPrice": 85.90,
  "cherryPrice": 2,
  "currency": "eur",
  "status": "validated",
  "mode": "test"
}
		
200 - Success
trackId string Le track ID, tel que nous l'avons enregistré.
orderPrice float Le montant total de la commande, tel que nous l'avons enregistré.
cherryPrice integer Le montant de la participation, tel que nous l'avons enregistré. Vous pouvez ainsi vérifier s'il correspond à ce que vous avez facturé au client.
currency string La devise de la commande, telle que nous l'avons enregistrée.
status string Le statut de la commande, du coté de Cherry Checkout.
Valeurs possibles : 'validated' ou 'canceled'
mode string Le mode dans lequel la commande a été enregistrée.
Valeurs possibles : 'prod' ou 'test'
400 - Bad Request
trackId already exists 3001 Vous avez déjà crée une commande avec ce Track ID.
no charity available 3004 Vous n'êtes lié à aucune œuvre caritative. Si cette erreur se produit, contactez-nous.
customer not set 3006 Vous n'avez pas définis le champs Customer.
customer email is missing 3010 Vous n'avez pas renseigné l'adresse e-mail du client
unknown error 3030 Il s'est produit une erreur inconnue lors de la création de la commande. Si cette erreur se produit, contactez-nous.
orderPrice required 3031 Le montant total de la commande n'a pas été saisi, ou est invalide.
wrong currency 3032 La devise que vous avez fourni est incorrecte.
wrong status 3033 Le statut de la commande n'est pas correct.
unknown error 3040 Il s'est produit une erreur inconnue lors de la création du client. Si cette erreur se produit, contactez-nous.
invalid customer email 3041 L'e-mail du client que vous avez fourni n'est pas valide.
missing customer firstname 3042 Vous n'avez pas fourni le prénom du client.
missing customer lastname 3043 Vous n'avez pas fourni le nom du client.
500 - Server Error
server error 8000 8999 Une erreur s'est produite sur nos serveurs.

Conclusion

Si votre requète se déroule sans erreur, vous pouvez vérifier qu'elle a correctement été passée en vous rendant dans votre dashboard. Maintenant que vous êtes capable de créer une commande, nous allons voir comment il est possible de la modifier, ou même de l'annuler.


Besoin d'aide ?

N'hésitez pas à contacter notre support technique si vous rencontrez des difficultés.