RedX: parcels with a price check
Connect RedX with one API token per mode. Sandbox and live tokens, pickup stores, the delivery area and price, the webhook and common errors.
RedX needs a single token per mode, which makes the setup short. The one thing to get right is to use the token that matches the mode.
What it is#
RedX is a courier that delivers parcels across Bangladesh and collects cash on delivery. In Jukto you pick the delivery area from one list, see the delivery charge and the cash-on-delivery fee before booking, and can cancel a booking from the order. It suits shops that want both a price check and cancellation from Jukto.
What you need#
- A RedX merchant account with at least one pickup store.
- Fields in Jukto:
| Field in Jukto | What it is |
|---|---|
| API token | The token from your RedX dashboard (a secret) |
| Pickup store ID | Optional. Empty means your first RedX pickup store |
Where to find your keys#
- 1
Open Developer API
Sign in to your RedX merchant dashboard and open Developer API.
- 2
Request the token
Press Request token. Ask for the sandbox token to test, and the live token for real parcels.
- 3
Copy the token
Copy the token into API token. Make sure the mode you choose in Jukto matches the token you pasted.
- 4
Choose the pickup store
Leave Pickup store ID empty to use your first RedX pickup store, or enter the ID of the one you want. It must be a pickup store ID, not your shop ID.
What Jukto does#
- Keys. Saved encrypted for this website only.
- Area and price. The Courier card shows one list of RedX delivery areas. After you pick the area, Get the price shows the delivery charge and the cash-on-delivery fee separately, plus the total.
- Booking. Jukto creates the RedX parcel with the buyer's name, phone, address, area, the weight in grams, the declared value and the cash to collect (0 for a paid order). RedX returns a tracking ID.
- Status. Jukto reads open parcels every 15 minutes, or at once with Check status now. With the webhook set, RedX tells Jukto on every status change.
- Webhook. In the RedX merchant dashboard open Developer API > Webhook and paste the Webhook address from the RedX provider page as the callback URL. RedX does not sign its calls: the long code inside the address is the secret, so keep the address private. Jukto checks a status with RedX before it uses it. Make a new address replaces the code and the old address stops working at once.
- Cancel. Cancel booking on the order also cancels the parcel at RedX.
Text version of the diagram
- Pick the delivery area to Get the price
- Get the price to Book with RedX
- Book with RedX to Tracking ID saved on the order
- Tracking ID saved on the order to Status updates arrive
Test and turn on#
- 1
Open the provider
Go to Dashboard > Tools > Integrations, open the Couriers group and choose RedX.
- 2
Choose the mode and fill the fields
Pick Sandbox (testing) or Live to match the token, paste the API token and press Save.
- 3
Press Test connection
Jukto asks RedX for the areas of Dhaka. You see "Connected to RedX (sandbox)" or "(live)" with the number of areas.
- 4
Press Turn on
In Sandbox the parcels are test parcels. Move to Live with the live token when you are ready.
- 5
Book one parcel
Open a confirmed order, pick the delivery area, press Get the price and Book with this courier.
Common errors#
| What you see | What it means | What to do |
|---|---|---|
| Fill in: API token | The token is missing | Paste the token and save |
| RedX areas: the courier did not accept the saved keys (401) | The token is wrong, or the mode does not match it | Request the token again; check Sandbox or Live |
| the courier did not answer in time; try again in a moment | RedX was slow | Try again in a minute |
| pick the RedX delivery area first | No area chosen when asking for the price | Choose the area on the Courier card |
| pick the RedX delivery area before booking | No area chosen when booking | Choose the area, then book |
| RedX has no pickup store on this account; add one in the RedX merchant dashboard | You have no pickup store | Add a pickup store in RedX |
| the RedX pickup store has no area | The pickup store has no area set | Fix the store in the RedX dashboard |
| RedX answered without a tracking id | RedX did not create the parcel | Check the phone and address, then try again |

Comments (0)
Anyone can comment. Please do not post phone numbers, passwords or customer details.