Skip to main content

​
QR Code Deposit & Delivery

ColisMove uses QR codes to securely validate parcel handoffs at two critical points: deposit (sender → carrier) and delivery (carrier → recipient).

​
How It Works

​
Deposit Flow

​
Delivery Flow

​
API Endpoints

​
Generate QR Code

GET /v1/api/qrcode/generate?reservationId=123&type=DEPOT
Returns a PNG image containing the QR code. The type parameter can be DEPOT or LIVRAISON.

​
Validate QR Code

POST /v1/api/qrcode/validate
{
  "reservationId": 123,
  "code": "ABC123"
}
Validates the code without processing the transition. Useful for pre-validation.

​
Process Deposit

POST /v1/api/qrcode/process-depot
{
  "reservationId": 123,
  "code": "ABC123"
}
Validates the code and transitions the booking to EN_COURS_DE_LIVRAISON.

​
Process Delivery

POST /v1/api/qrcode/process-livraison
{
  "reservationId": 123,
  "code": "XYZ789"
}
Validates the code and transitions the booking to LIVREE, triggering carrier payment.

​
Recipient Page

For recipients who don’t have the app, a web page is available: 
GET /v1/api/destinataire/page/{reservationId}
This returns an HTML page with delivery information and a QR code scanner, allowing recipients to confirm delivery via their phone browser.
Each QR code is single-use. Once processed, it cannot be reused. A new code must be generated if needed.