Help Center
Help Center›Shipping

How to Connect Your Own J&T Account

Updated
Feature Availability User Permissions Time to Complete Skill Level
Philippine stores on Launch, Grow, Scale and the free trial Store owner, or a team member with Store settings & administration access About 10 minutes Intermediate

Summary

Overview: If you have your own J&T account, you can connect it with your J&T credentials. Your Standard Delivery bookings are then made on your own J&T account, and J&T bills you directly instead of Prosperna. Customers stop paying Prosperna's 3% service fee, and you can set your own markup or flat rates. If you leave this disconnected, your store keeps using Prosperna's J&T account through the Prosperna Shipping - J&T Marketplace Add-on.

Prerequisites:

  • A Philippine store on Launch, Grow, Scale or the free trial.
  • Store owner access, or a team member with Store settings & administration access.
  • Your J&T account credentials: Company ID, Customer ID and API Key. Get these from J&T.
  • Standard Delivery activated, set up, switched on and given a pickup address. See "How to Ship with Prosperna's Courier Partners". You can connect your credentials before or after this, but Standard Delivery won't appear at checkout until it's done.

Step-by-Step Instructions

Step 1: Open the J&T connection section

  1. In the sidebar, click Settings, then Shipping.

  2. Scroll below the shipping cards to Connect your own J&T account.

  3. If you see Before your customers can see Standard Delivery, follow its three items on the Standard Delivery card. Each item gets a tick when it's done, and the box disappears once all three are finished:

    1. Activate J&T.
    2. Open Set Up and add your pickup address, the address couriers collect your packages from.
    3. Switch on Standard Delivery. The switch appears on the card once you've saved step 2.

    The pickup address section only appears after Standard Delivery is switched on. So save the Set Up page first, switch the method on, then click Manage to add the pickup address.

Step 2: Connect your J&T credentials

  1. Enter your Company ID.
  2. Enter your Customer ID.
  3. Enter your API Key.
  4. Click Connect. Prosperna tests your connection to J&T before saving, so this can take a few seconds.
  5. When it works, you see J&T account connected.

Step 3: Check your connection

After you connect, the section shows:

  • a Connected badge and Your J&T account is verified and connected.
  • Company ID: and Customer ID: with the IDs you entered. Your API key is never shown again.
  • Delivery status updates: "No setup needed with J&T. Order delivery status updates refresh automatically every 30 minutes after booking."
  • Delivery rates: a reminder that you don't need to set rates (see Step 4).

There's no webhook to set up for J&T.

Step 4: Choose your delivery rates (optional)

By default, customers pay the J&T delivery fee without Prosperna's 3% service fee. To change this:

  1. On Settings → Shipping, click Manage on the Standard Delivery card, then the Rates tab.
  2. Under Who Pays for Shipping?, keep Customer.
  3. Under Shipping Fee Calculation, choose one of these and click Confirm in the Warning window:
    • Auto-Calculated by Courier: the customer pays the J&T fee.
    • Courier Quote + Your Add-ons: the J&T fee plus a Markup % (0 to 100) and an extra fee you set per province. Type the markup and click outside the box to save it.
    • Flat Shipping Fee: your own rates replace the J&T fee.

For how to set per-province fees and flat rates, see "How to Set Up Manual Shipping and Shipping Rates".

Step 5: Book and pay for deliveries

You book Standard Delivery orders the same way as before: open the order and click Book a Rider (see "How to Ship with Prosperna's Courier Partners").

What changes once you're connected:

  • New bookings are made on your own J&T account, and J&T bills you directly.
  • These bookings never use Prosperna's Shipping Credits.
  • The delivery status of these orders is checked with J&T every 30 minutes, and the order updates on its own.

Step 6: Disconnect your J&T account (optional)

  1. In Connect your own J&T account, click Disconnect.
  2. In the Disconnect J&T account window, read the message: your store goes back to the Prosperna-managed J&T account for booking and billing, and your credentials are removed.
  3. Click Disconnect. You see J&T account disconnected.

You can connect again at any time by repeating Step 2.

Verify It Worked

Success criteria:

  • You saw J&T account connected.
  • The section shows the Connected badge with your Company ID and Customer ID.
  • On the Standard Delivery card's Rates tab, the options now include Courier Quote + Your Add-ons and Flat Shipping Fee.

Troubleshooting

Common errors

  • "Please enter your company ID, customer ID, and API key.": one of the boxes is empty. Fill in all three and click Connect again.
  • "J&T rejected these credentials. Double-check your eccompany ID, customer ID, and API key.": J&T didn't accept the details, and nothing was saved. Check each value with J&T and try again. Your Company ID is the value this message calls "eccompany ID".
  • "Could not reach J&T to validate the credentials.": Prosperna couldn't reach J&T. Wait a moment and try again.
  • "Failed to connect your J&T account.": the connection didn't go through. Try again.
  • "Failed to disconnect.": the account wasn't disconnected. Try again.
  • Standard Delivery doesn't appear at checkout: finish the three items in Before your customers can see Standard Delivery (Step 1).
  • A delivery status hasn't changed: statuses are checked every 30 minutes. Orders created more than 14 days ago are no longer checked automatically.

Limitations & considerations

  • Only Philippine stores can connect a J&T account.
  • Courier Quote + Your Add-ons and Flat Shipping Fee are only offered while your own J&T account is connected.
  • The J&T fee shown at checkout is calculated by Prosperna from its J&T rate table, not from your own J&T contract. J&T bills you under your own agreement, so the amount J&T charges you can differ from what your customer paid. That difference is yours.
  • The same J&T account can be connected to more than one of your stores.

Next Steps & Related Resources

Need more help? For more information and assistance, please send an email to support@prosperna.com.

Last Updated: 10/09/2026