> For the complete documentation index, see [llms.txt](https://justespilon.gitbook.io/srp-encyclopedie/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://justespilon.gitbook.io/srp-encyclopedie/guides-particuliers/code-de-paiement.md).

# Code de paiement

Guide présentant le fonctionnement des codes de paiement.

## 💳 <mark style="color:$primary;">`Le système de codes de paiement`</mark>

Sur Simple Roleplay, les codes de paiement permettent de <mark style="color:$primary;">**transmettre de l'argent à un autre joueur**</mark> sans avoir besoin d'effectuer directement la transaction avec celui-ci.

Un code peut être acheté auprès de certains PNJ présents dans les <mark style="color:$primary;">**stations-service**</mark>, puis activé par la personne destinée à recevoir le paiement.

{% hint style="warning" %}
**Les codes de paiement ne doivent pas être utilisés pour stocker de l'argent.**&#x20;
{% endhint %}

***

### ⛽ <mark style="color:$success;">`Acheter un code de paiement`</mark>

Il est possible d'acheter un code de paiement auprès de deux PNJ :

* ⛽ <mark style="color:$success;">**Thomas Boileau**</mark> à la Station-service ville
* ⛽ <mark style="color:$success;">**Romane Boileau**</mark> à la Station-service campagne

<div><figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2F5cZSn7Vj05GoRyzDFZAl%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Emplacement%20PNJ%20Thomas%20Boileau.png?alt=media&amp;token=7767bfe5-9520-4e71-9c6a-a401e2c2e3ba" alt=""><figcaption></figcaption></figure> <figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2FFEKHL9YJJp8YkR6rtYBY%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Emplacement%20PNJ%20Romane%20Boileau.png?alt=media&amp;token=a891db84-880a-46e9-b61b-0cd2064f51f0" alt=""><figcaption></figcaption></figure></div>

Pour acheter un code, ouvrez le menu de Thomas Boileau ou Romane Boileau, puis sélectionnez : <mark style="color:$success;">`Je souhaiterais acheter un code de paiement.`</mark> Il suffira de saisir le montant du code et le code vous sera alors communiqué après l'achat et automatiquement copier dans votre presse-papier.

<figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2FSMseF5odlzNO5cwlw3HT%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20PNJ%20Romane%20Boileau%20et%20PNJ%20Thomas%20Boileau%20-%20Acheter%20un%20code.png?alt=media&amp;token=62b2a5d4-cf3a-4abc-9350-0c111c753b4f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2FpxcRCFID58jSQieVoJxa%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20achat%20d'un%20code%20de%20paiement.png?alt=media&amp;token=ddd73d71-8a5b-495e-9ac9-77f9850a638e" alt="" width="516"><figcaption></figcaption></figure>

<figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2FoGIcBXjwqxtHLXWZh7Wv%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Message%20re%C3%A7u%20lors%20de%20l'achat%20d'un%20code.png?alt=media&amp;token=e4833ac9-7397-40da-9d0f-f828efc62caf" alt=""><figcaption></figcaption></figure>

***

### 💰 <mark style="color:orange;">`Récupérer un paiement`</mark>

Si vous êtes la personne destinée à recevoir l'argent d'un code de paiement, rendez-vous auprès de Thomas Boileau ou Romane Boileau.

Dans le menu du PNJ, sélectionnez : <mark style="color:orange;">`Je souhaite gérer mon espace vendeur.`</mark>

<figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2F90Z5u6RSK23zETiG59Zy%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20PNJ%20Romane%20Boileau%20et%20PNJ%20Thomas%20Boileau%20-%20Espace%20vendeur.png?alt=media&amp;token=65e24e1a-a0c8-4d1f-b800-b262756dad4b" alt=""><figcaption></figcaption></figure>

Sélectionnez ensuite : <mark style="color:orange;">`Je souhaite activer un code.`</mark>

<figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2FkvLUmzkVqibcYhQSZ3cu%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20espace%20vendeur%20-%20Activer%20un%20code.png?alt=media&amp;token=e5d97e43-b057-4bdc-a195-37a2b76b5073" alt=""><figcaption></figcaption></figure>

Entrez ensuite le <mark style="color:orange;">**code de paiement**</mark> qui vous a été transmis. Une fois le code activé, le paiement est associé à votre espace vendeur.

Pour récupérer l'argent, retournez dans : <mark style="color:orange;">`Je souhaite gérer mon espace vendeur.`</mark> puis sélectionnez : <mark style="color:orange;">`Je souhaite récupérer mes codes activés.`</mark>

<figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2FbGcpICSUPY0hu7uSueqf%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20espace%20vendeur%20-%20R%C3%A9cup%C3%A9rer%20les%20codes.png?alt=media&amp;token=6314dd01-53f4-4c22-ba60-14d3ecfb9a1b" alt=""><figcaption></figcaption></figure>

L'argent correspondant aux codes activés vous sera alors versé.&#x20;

***

### 🔑 <mark style="color:$warning;">`La clé vendeur`</mark>

Si vous n'arrivez pas à activer un code de paiement, il est possible que vous ne possédiez pas encore de <mark style="color:$warning;">**clé vendeur**</mark>.

Pour en obtenir une, rendez-vous auprès de Thomas Boileau ou Romane Boileau, puis ouvrez : <mark style="color:$warning;">`Je souhaite gérer mon espace vendeur.`</mark>

Sélectionnez ensuite : <mark style="color:$warning;">`Je souhaite obtenir une clé pour recevoir mes paiements.`</mark>

<figure><img src="https://2836320271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH6c1PnACwlfn3XdV7GDK%2Fuploads%2FhsFlGEjZVPXpgNp0xOUe%2F%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20%5BSRP%5D%20Encyclop%C3%A9die%20-%20Menu%20espace%20vendeur%20-%20Obtenir%20une%20cl%C3%A9.png?alt=media&amp;token=c3c4622c-3c68-4cb0-a5f6-3c626e02f7b4" alt=""><figcaption></figcaption></figure>

Cette clé vous permettra notamment de recevoir vos paiements et peut également être utilisée avec l'API des codes de paiement.

{% hint style="danger" %}
**Votre clé vendeur est personnelle. Elle ne doit être communiquée à personne.**&#x20;
{% endhint %}

***

### 🤖 <mark style="color:blue;">`Utilisation avec un robot Discord`</mark>

La clé vendeur peut notamment permettre de mettre en place un système automatisé.

Par exemple, un <mark style="color:blue;">**robot Discord**</mark> pourrait permettre à des joueurs de saisir un code de paiement dans un formulaire Discord. Le robot pourrait ensuite utiliser votre clé vendeur pour effectuer une requête auprès de l'API et <mark style="color:blue;">**réclamer le code reçu dans le formulaire**</mark>.

Cela peut être particulièrement pratique pour automatiser la réception de paiements dans le cadre d'une entreprise ou d'une organisation.

{% hint style="warning" %}
Si vous développez un système utilisant l'API, vous êtes responsable du respect de son règlement et de la protection de votre clé vendeur.
{% endhint %}

#### 📚 <mark style="color:cyan;">`Documentation`</mark>

* [Documentation de l'API](https://docs-srp.azzen.dev/)
* [Documentation des codes de paiement](https://api.simple-roleplay.fr/public/code/)&#x20;

***

### 📜 <mark style="color:$warning;">`Règlement de l'API`</mark>

L'utilisation de l'API des codes de paiement est soumise à plusieurs règles.

> <mark style="color:violet;">`1.1`</mark> <mark style="color:violet;">**/public/**</mark> : Seules les routes présentes dans <mark style="color:violet;">`/public/`</mark> sont autorisées.&#x20;
>
> <mark style="color:violet;">`1.2`</mark> <mark style="color:violet;">**/waitforme/**</mark> : Il est interdit d'abuser des ressources de l'API. Le spam de requêtes et toute utilisation excessive de l'API sont notamment interdits.&#x20;
>
> <mark style="color:violet;">`1.3`</mark> <mark style="color:violet;">**/code/**</mark> : L'utilisation d'une **clé d'identification non personnelle** ou de **codes qui ne vous sont pas destinés** est proscrite. Utilisez uniquement votre propre clé et ne réclamez que les codes qui vous sont destinés.&#x20;

{% hint style="warning" %}
Il est interdit de **stocker de l'argent avec des codes de paiement.** Un code de paiement doit servir à **transmettre un paiement**, et non à conserver de l'argent virtuellement dans un code.
{% endhint %}