For developers

API Integration

Automate card production from your system. REST API, webhooks, full documentation.

Access documentation Talk to an engineer

Quick integration

Easy to integrate

A single HTTP request is all it takes to trigger printing, NFC encoding and shipping of a card. Webhooks for real-time tracking.

REST API with API key authentication
Webhooks for real-time status updates
Full sandbox for free testing
Complete OpenAPI (Swagger) documentation
Standardized and paginated JSON responses
Idempotency on creation requests

// Create a card order

POST https://api.printags.com/v1/orders

{
  "card_type": "ntag213",
  "design": {
    "template_id": "tpl_abc123",
    "variables": {
      "name": "Jean Dupont",
      "title": "Directeur technique",
      "photo": "https://..."
    }
  },
  "nfc": {
    "url": "https://example.com/jean"
  },
  "shipping": {
    "name": "Jean Dupont",
    "address": "12 rue de la Paix",
    "city": "Paris",
    "country": "FR"
  }
}

Architecture

Integration architecture

Your system communicates with the Printags API. We handle everything else.

Your system

ERP, CRM, e-commerce, SaaS

API RESTWebhooks

Printags

Printing + encoding + shipping

API Reference

Main endpoints

POST/v1/ordersCreate an order

GET/v1/orders/:idOrder status

GET/v1/orders/:id/trackingShipping tracking

POST/v1/designsUpload a design

GET/v1/templatesList templates

POST/v1/webhooksConfigure a webhook

GET/v1/cards/:idCard details

GET/v1/billing/usageMonthly usage

Webhooks

Real-time notifications

Receive automatic notifications on every status change. Configure your webhooks via the API or the dashboard.

order.created

Order received and validated

order.printing

Printing in progress

order.encoding

NFC encoding in progress

order.quality_check

Quality check passed

order.shipped

Package shipped, tracking number available

order.delivered

Delivery confirmed

Sandbox & security

Test with confidence

The sandbox environment replicates the production API. Test your integration at no cost and with no risk.

Sandbox identical to production
Separate API keys (test / production)
HTTPS required on all endpoints
Configurable rate limiting
Logs and history of all requests

Integration scenarios

How our integrators use the API

E-commerce

A customer orders a card on your store. The API automatically triggers production and shipping.

SaaS / Platform

Your platform manages members. With each sign-up, a card is automatically printed and shipped.

HR / Corporate

New employee = automatic badge. The API integrates with your HRIS to trigger production.

IoT / Kiosks

New subscriber to your kiosk network = NFC badge printed and shipped automatically via the API.

Events

Online registrations = personalized badges produced and sent to attendees before the event.

Loyalty program

New member of your program = NFC loyalty card printed with variable data and encoding.

Frequently asked questions

FAQ — API Integration

How long does integration take?

Most of our integrators are up and running in less than a day. The documentation is comprehensive, with code examples in multiple languages. A sandbox environment is available immediately.

Are SDKs available?

The API is a standard REST API (JSON over HTTPS). It is compatible with all languages and frameworks. We provide code examples and Postman collections to get started quickly.

Is the API available 24/7?

Yes, the API is available 24/7. We guarantee a 99.9% uptime SLA. Real-time status is available on our status page.

How does billing work?

Monthly subscription + per-card unit cost. The API endpoint /v1/billing/usage lets you track your usage in real time. Automatic billing at end of month.

Is the transmitted data secure?

Yes. HTTPS is required on all endpoints. Personal data (photos, names) is encrypted at rest and deleted after production. GDPR compliant.

Can I limit my users' API calls?

Yes, rate limiting is configurable. By default, 100 requests per minute. Adjustable based on your plan.

Ready to integrate?

Create your account and access the sandbox in 2 minutes. Full documentation available.

Create my integrator account API Documentation