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",
    "phoneNumber": "+33670230852",
    "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.
phoneNumber	string	Le numéro de téléphone mobile du client avec l'indicatif pays.
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.