Registration and API Key

To start using the SUIT Billing API, you need to obtain your credentials and configure your SUNAT settings.

Step 1: Get your credentials

Contact the SUIT team to receive:

Tenant ID — Your organization identifier
API Key — For server-to-server calls (format: sk_live_xxx...)
Admin credentials — Email and password for the SUIT Portal

Step 2: Upload your SUNAT certificate

Every tenant needs a digital certificate (.pfx) from SUNAT to sign documents. Upload it via the API:

curl -X PUT https://api.suit.pe/api/settings/certificate \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "certificate": "BASE64_ENCODED_PFX_FILE",
    "certPassword": "your_certificate_password"
  }'

See the PFX Certificates guide for details on obtaining and converting your certificate.

Step 3: Configure SUNAT SOL credentials

Set your SOL (SUNAT Operaciones en Linea) credentials:

curl -X PUT https://api.suit.pe/api/settings/sunat-credentials \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "solUser": "YOUR_SOL_USER",
    "solPassword": "YOUR_SOL_PASSWORD"
  }'

For sandbox testing, use the beta credentials:

solUser: MODDATOS
solPassword: MODDATOS

See the SOL Credentials guide for more information.

Step 4: Emit a test document

Once configured, you are ready to emit your first invoice.

API Key security

Your API Key (sk_live_xxx...) grants full access to your tenant’s data and operations. Follow these best practices:

Store it in environment variables, never in source code
Use different API keys for different integrations (label them accordingly)
Rotate keys periodically
Revoke compromised keys immediately via DELETE /admin/tenants/:tenantId/api-keys/:keyId