Support

Contact us

Email printapicustomersupport@rpiprint.com with any question about the API or your orders.

Support hours are Monday to Friday, 8 AM to 5 PM Pacific Time, except RPI holidays.

For a question about your integration, include whether you used a sandbox or production API key, the order ID, the API request data (preferably as a curl command), and any error message. Before you send the request, remove or replace every value that is a credential or personal data: the Authorization header, the recipient's name, address, phone and email, pre-signed file URLs, and any token in the webhookUrl. Send the smallest request that shows the problem.

For a question about a specific order, include your customer name and the order identifier, or a link to the order in the RPI Print API Dashboard.

FAQs

General

1. What fees or costs are associated with using the RPI Print API?

   There are no fees for setting up or using the API. You are charged for print orders: books, fulfillment and shipping, and sales tax as applicable.

2. Where can I find the list of standard products offered?

   The RPI Print website gives an overview of the available book sizes, bindings, and papers. If you already have an account, you can also review the Products section of the dashboard.

   The Product specifications page shows the options that affect a product's specifications, and has downloadable templates and guidance on setting up your files. You can explore further customizations in the dashboard's add product wizard.

Product setup

1. How do I get started?

   1. Create an account at api.rpiprint.com.
   2. Work with your developer (or yourself, if that is also you) to configure your API credentials. The API Endpoints and Webhooks documentation will help you get started.
   3. Choose products from our catalog before you start accepting orders. See our Product specifications. When you add a product, you select its attributes and see its book price, excluding taxes and shipping.
   4. Place a test order in Sandbox.
   5. Switch the dashboard to Production.

   Getting started explains each step in detail.

2. How do I add my products?

   Go to the Products page in the dashboard and select your attributes: size, cover, paper type, text color, and bleed. You see the book price, excluding tax and shipping, as you go. After you select your attributes, you can edit the product SKU and product name, for which we provide a default naming convention, and add a description. Your product SKU is what you send in each order.

   To edit a product later, open the menu (three dots) at the right end of the product's row in the Products list.

3. Can I get proofs or samples of my products and/or the standard products you offer?

   At this time, we do not offer complimentary samples. We recommend placing a production order for the exact product you plan to sell. That order tests your setup end to end and gives you a physical copy of your product. Sandbox orders are not printed; they let you test the API integration itself.

Orders, Shipping, and Payments

1. Is there a limit on the number of orders I can place per day?

   You may place up to 50 orders in a rolling 24-hour period. Reprints do not count toward the limit. Orders over the limit wait in a queue and are released as the limit allows, and their SLAs and shipping dates are updated to match.

   The queue has a ceiling of 350, which counts received and queued orders together. With the default limits, up to 300 orders can wait in the queue, and RPI rejects any order past the ceiling. RPI emails the address on record when you go over your limit.

   Both numbers are defaults. To change them, contact printapicustomersupport@rpiprint.com.

2. How long do I have to cancel an order?

   After an order's payment succeeds, the order waits in a holding bin for 2 hours before it is sent to the printer. Until the order leaves the holding bin, a cancellation always succeeds.

   After that, and until the order ships, a cancellation sends a request to the printer, and the order moves to CANCELLATION_REQUESTED. The printer can accept or refuse the request. A shipped order cannot be cancelled.

3. How do I cancel an order?

   Call the cancel endpoint, DELETE /orders/{customerOrderId}, any time before the order ships, except while its status is VALIDATING, CANCELLATION_REQUESTED or EXCEPTION. The previous answer explains when the printer decides the outcome.

4. How long will it take to manufacture my products?

   Manufacturing takes 4 business days for Standard and Expedited shipping, and 3 business days for Rush. Manufacturing happens before the order ships, so add the shipping speed's transit time to get the total. See Shipping.

5. What shipping methods are available?

   RPI offers Standard, Expedited, and Rush. Which of them a destination sells varies, so call POST /orders/shipping/estimate for an address. See Shipping.

6. What shipping rates are available?

   Rates depend on the destination and on how many items the order contains. See Shipping for the rate tables, and call POST /orders/shipping/estimate for the price of a specific order.

7. Do you ship internationally?

   Yes, to Canada. RPI also ships to the US, Puerto Rico, and the US territories. Orders to Canada, Puerto Rico, and the US territories need a retailPrice on every item for customs. Canadian orders ship DAP (Delivered at Place), so the recipient pays any import duties and customs charges. See Shipping for the speeds and rates each destination sells, and call POST /orders/shipping/estimate to confirm what a particular address can be sold.

8. How do I pay for orders?

   RPI charges your production orders to the credit card on your account. A Customer Admin adds the card on the Payments page of the dashboard.

   RPI charges the card once a day at 02:00 UTC for every order in the VALID_AWAITING_PAYMENT status. That is 9 PM Eastern and 6 PM Pacific in winter, and 10 PM Eastern and 7 PM Pacific during daylight saving time. A production order stays in VALID_AWAITING_PAYMENT until its payment succeeds. The dashboard shows when your next charge is expected.

9. What forms of payment do you accept?

   We accept Visa, MasterCard, and American Express credit cards. We charge in US dollars (USD) only. International credit cards are accepted. When selecting the associated country for your card, you can type the name of the country to filter.

10. Will I be charged taxes?

    Orders are charged sales tax by default, based on RPI's ship-from address and your order's destination.

    If you are eligible for tax exemption, for example as a reseller, you can upload your documentation so that you are not charged unnecessary taxes. Only a Customer Admin sees the Tax exemption section. To upload your documentation, switch the dashboard to Production, open the Payments page, and find your Tax exemption options at the bottom of the page. If your status says "Not tax exempt", upload your documentation.

    Once you upload it, you will receive an email confirming that you will not be charged taxes. If a review finds your documentation invalid, your status is changed to "Not tax exempt", and you receive an email asking you to upload a valid tax document.

    Tax exemption is not available for Canadian sales tax at this time.

Technical Integration Setup

1. How does Sandbox work?

   Every account includes Sandbox, and it is on by default for new users. Switch modes with the toggle at the right end of the banner across the top of every dashboard page. Sandbox orders are never printed or charged.

   Orders and API credentials are separate for each mode. Products are shared by both modes, so a product you test in Sandbox is ready to use in production. Orders placed with sandbox credentials are sandbox orders.

2. How do I test payments in Sandbox mode?

   You can simulate a payment succeeding or failing from the Orders page while the dashboard is in Sandbox mode. Open the Test Order Payments menu above the orders table and choose Payment Success or Payment Failed. Sandbox orders never charge a card, so you do not need a real payment method.