OVERVIEW
The Partners API is used to create and manage users in Wrapp via API calls.
An AI-friendly Markdown version of this documentation, ideal for LLMs and coding agents, is available at
https://wrapp.ai/api/partnersonboarding.md
GETTING ACCESS
To use the Partners API, request an API key through the contact form.
Include the API key in your request headers as:
X-PARTNER-API-KEY: <your_key_here>
https://wrapp.ai/api/v1/
X-PARTNER-API-KEY: xxxxxxxxxxxxxxxxxxxxxxxxxxx
CREATE / LOGIN USER
To create a new user or log in an existing one, make a POST request to:
https://wrapp.ai/api/v1/external_login
Wrapp.ai will respond with a login_url that the user can use to log in.
PARAMETERS
| Param Name | Required | Type | Description |
|---|---|---|---|
| yes | string | Email of the user that will be used to create their account in Wrapp.ai | |
| partner_user_id | yes | string | External unique identifier that will be used to identify the user in Wrapp.ai |
| phone | yes | string | Phone of the user that will be used to create their account in Wrapp.ai |
| webhook_endpoint | no | string | Webhook endpoint that will return details on user creation |
curl -L 'https://wrapp.ai/api/v1/external_login' \
-H 'X-PARTNER-API-KEY: XXXXXXXXXXXXXXXXXXXXXXXX' \
-H 'Content-Type: application/json' \
-d '{
"email": "[email protected]",
"partner_user_id": "abc123",
"phone": "1234567890",
"webhook_endpoint": "https://yoursite.com/webhook"
}'
{
"login_url": "https://wrapp.ai/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
WEBHOOK · USER CREATED
If the user was created, Wrapp.ai will send the following payload to the provided
webhook_endpoint:
FIELDS
| Param Name | Description |
|---|---|
| wrapp_user_id | Id of the user in Wrapp |
| partner_user_id | Id of the user in partner (the id provided in the initial call) |
| api_key | API key of the user, used for further API actions on their behalf |
{
"wrapp_user_id": "xxxxx-xxxxx-xxxxx-xxxxx",
"partner_user_id": "xxxxxxxxxx",
"api_key": "xxxxxxxxxxxxxxxxxxxxx"
}
CHECK USER
This endpoint shows if the user exists and whether they have an active subscription.
Make a POST request to:
https://wrapp.ai/api/v1/embedded_check_user
PARAMETERS
| Param Name | Required | Type | Description |
|---|---|---|---|
| partner_user_id | yes | string | Unique identifier that has been used to identify the user in Wrapp.ai |
RESPONSE FIELDS
| Name | Type | Description |
|---|---|---|
| user | string | User's email |
| active_subscription | boolean | User's subscription status |
curl -L 'https://wrapp.ai/api/v1/embedded_check_user' \
-H 'X-PARTNER-API-KEY: XXXXXXXXXXXXXXXXXXX' \
-H 'Content-Type: application/json' \
-d '{"partner_user_id": "abc123"}'
{
"user": "[email protected]",
"active_subscription": false
}
Συχνές ερωτήσεις
Τι είναι το Wrapp Partners API;
Είναι το API multi-tenant onboarding της Wrapp: δημιουργείς και διαχειρίζεσαι λογαριασμούς Wrapp (subaccount ανά ΑΦΜ) για τους τελικούς πελάτες σου προγραμματιστικά, ώστε η εφαρμογή σου να τους ενεργοποιεί για έκδοση παραστατικών myDATA χωρίς χειροκίνητα βήματα.
Πώς δημιουργώ λογαριασμό Wrapp για κάθε πελάτη μου μέσω API;
Καλείς POST /api/v1/external_login με email, partner_user_id και τηλέφωνο. Η Wrapp επιστρέφει ένα login_url για τον χρήστη και, μόλις δημιουργηθεί ο λογαριασμός, στέλνει webhook με το wrapp_user_id και το api_key του tenant· με αυτό εκδίδεις παραστατικά για λογαριασμό του.
Πώς θα πάρω Partner API key (X-PARTNER-API-KEY);
Το Partners API ενεργοποιείται ανά συνεργάτη: ζήτησέ το μέσα από τη φόρμα επικοινωνίας· λαμβάνεις staging key για δοκιμές και production key όταν είσαι έτοιμος.
Πώς ελέγχω αν ένας πελάτης έχει ήδη λογαριασμό ή ενεργή συνδρομή;
Με POST /api/v1/embedded_check_user και το partner_user_id: η απάντηση επιστρέφει το email του χρήστη και το αν έχει ενεργή συνδρομή (active_subscription).
Ποια είναι η διαφορά του Partner key από το API key του tenant;
Το X-PARTNER-API-KEY αφορά μόνο το onboarding: δημιουργία και έλεγχο χρηστών μέσω του Partners API. Κάθε tenant λαμβάνει δικό του api_key, με το οποίο κάνει login στο Invoice Issue API και εκδίδει τα παραστατικά του.
Ποιος υπογράφει σύμβαση και χρεώνει τον τελικό πελάτη;
Η Wrapp: ο τελικός χρήστης αποδέχεται ψηφιακά τη σύμβαση και πληρώνει τη συνδρομή του κατά το onboarding. Η εφαρμογή σου παραμένει το front-end· δεν διαχειρίζεσαι χρεώσεις ή συμβάσεις.