# How to integrate with Sparados API # Sparados API ### Onboarding #### **Here's a short instruction for the essential steps before calling Sparados API:** ##### **Essential steps before calling Sparados API:** **1. Create an x509 Certificate for Server-to-Server Communication** This API requires Mutual TLS authentication. You can use the same certificate for all mTLS-secured APIs exposed by Sparados. If you don't have one, follow this instruction: [Connecting to server-to-server APIs](https://developer.sparados.com/books/how-to-integrate-with-sparados-api/page/connecting-to-server-to-server-apis "Connecting to server-to-server APIs") **2. Receive Corporation Information from Sparados** - After Sparados signs the certificate, you will receive the following information from them: - Corporation ID - Balance ID - Signed certificate (name: V-{Companyname}-BudgetControl) - Optionally, you may also receive personalized visuals and their IDs for your cards. **3. API addresses **
Instance | BETA | PROD |
Cards API | https://sparados-bc-api.secure-verestro.dev/secure | https://sparados-bc-api.secure-verestro.com/secure |
Transaction API | https://services.upaidtest.pl/thc | https://services.upaid.pl/thc |
Field | Example value |
---|---|
Common Name (CN) | `V-Sparados-{CompanyName}` Company Name should be replaced with name of your company. |
Organization (O) | Name of your company |
Organizational Unit (OU) | \[UUID\] corp\_id sent by Sparados admin |
Locality (L) | City where your organization is located |
State/County/Region (ST) | State/County where your organization is located |
Country (C) | Two-letter country code where organization is located (ISO 3166-1 alpha-2) |
Email Address | Email to be contacted in case of forced renewal |
**Remember to replace parameters and file names with your own data** Commas cannot be used in parameters Minimum key length is RSA 2048
```shell openssl req -new -newkey rsa:4096 -keyout companyName.key -out companyName.csr -nodes -subj '/C=US/ST=Florida/L=Miami/O=SomeCompany/OU=UUID/CN=V-Sparados-CompanyName/emailAddress=example@user.com' ``` ---