---
title: "Enregistre une VENTE et la rattache au placement d'origine de la personne. Montant en CENTIMES. `invoiceId` rend l'appel idempotent : le rejouer ne facture jamais deux fois. Une vente ne peut PAS être envoyée depuis un navigateur."
method: POST
path: "/api/v1/sales"
tags: ["sales"]
---

# Enregistre une VENTE et la rattache au placement d'origine de la personne. Montant en CENTIMES. \`invoiceId\` rend l'appel idempotent : le rejouer ne facture jamais deux fois. Une vente ne peut PAS être envoyée depuis un navigateur.

`POST /api/v1/sales`

## Request

- Base URL: `https://subtraq.co`
- URL: `https://subtraq.co/api/v1/sales`
- Auth: HTTP bearer

## Request body

- object
  - `space` string, required: Raccourci de l'espace client.
  - `email` string: Email de la personne — le plus simple pour la retrouver.
  - `externalId` string: Son identifiant dans votre système, si vous en avez un.
  - `clickId` string: Identifiant de clic, si vous l'avez conservé.
  - `amount` integer, required: Montant en CENTIMES. 43 € s'écrit 4300.
  - `currency` string: Code à trois lettres. USD par défaut.
  - `invoiceId` string, required: Votre numéro de facture — c'est lui qui garantit l'idempotence.

## Response `200`

Succès.

## Other responses

- `201`: Créé.
- `400`: Paramètres invalides.
- `401`: Clé absente ou révoquée.
- `402`: Quota de la formule atteint.
- `403`: La clé n'a pas le droit demandé.
- `404`: Introuvable dans ce compte.
- `409`: Conflit — un raccourci déjà pris, par exemple.

---

[API](https://skmtc.dev/subtraq/apis/subtraq-api.md) · [All operations](https://skmtc.dev/subtraq/apis/subtraq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/subtraq/apis/subtraq-api/revisions/1a3dacdd7d28?raw)