Test mode
A tjy_test_ key runs every Shipment with a simulated partner. Use it to build and test your integration end to end, including webhooks and the event stream.
How test mode differs
Section titled “How test mode differs”-
Tujyane bills nothing, and TEST Shipments do not count toward your credit limit.
-
No real partner sees a TEST Shipment.
-
A quote always answers
partnersAvailable: trueandpickupEtaSeconds: 300. -
The partner is always the same:
{"firstName": "Test Partner","phone": "250780000000","vehicle": { "type": "MOTORCYCLE", "plate": "RAC 000T", "model": "Test motorcycle", "color": null }} -
A cancellation after assignment answers
offence: true, but Tujyane records nothing. -
Expiry, cancel, retry, not-received and every error work as in live mode.
-
With Delivery Codes on, the simulated partner enters the right code, so
deliveryConfirmedByisCODE. Otherwise it isPARTNER. It delivers at the drop-off point.
Choose the outcome
Section titled “Choose the outcome”Put a keyword in the Shipment’s reference to choose what happens:
reference contains |
Outcome |
|---|---|
| No keyword | Delivered |
unreachable |
Fails with RECIPIENT_UNREACHABLE, then returned |
refused |
Fails with REFUSED, then returned |
wrong-address |
Fails with WRONG_ADDRESS, then returned |
damaged |
Fails with DAMAGED, then returned |
no-partner |
NO_PARTNER_FOUND |
The match ignores case. Tujyane checks the words in this order and uses the first match: no-partner, unreachable, refused, wrong-address, damaged. For example, IH-20482-no-partner gives NO_PARTNER_FOUND, and IH-20483-refused gives REFUSED.
A retried Shipment always follows the default timeline, so a no-partner Shipment that you retry is delivered.
Timeline
Section titled “Timeline”After you confirm, the simulated partner follows this timeline. Each step waits for the one before it, so a run can finish 10 to 30 seconds later than shown.
| Seconds after confirm | Delivered | Failed (keyword) | no-partner |
|---|---|---|---|
| 5 | shipment.assigned |
shipment.assigned |
shipment.no_partner_found |
| 15 | shipment.partner_arrived_pickup |
shipment.partner_arrived_pickup |
|
| 25 | shipment.picked_up |
shipment.picked_up |
|
| 28 to 52 | partner.position every 3 seconds (stream only) |
Same | |
| 45 | shipment.partner_arriving |
shipment.partner_arriving |
|
| 55 | shipment.delivered |
shipment.delivery_failed |
|
| 65 | shipment.returned |
||
30 minutes after no_partner_found |
The retry window closes, with no event. |

