Use this system if you have a web server and want orders received through your store delivered to you in real time over the Internet, or if you're using services you want to make real-time order posts to. You may make real-time order posts to up to 5 URLs.

You can set up real-time order posts using the Real-Time Links Settings page, located in the Real-Time Links section of Store Manager. Note: This feature is not available with Merchant Solutions Starter plans.

You must specify a URL (starting with https if you want to receive the full order information) and a format. A format can be selected for each URL you make order posts to. We recommend the Yahoo or XML formats, which are very easy to parse with a simple CGI script. The system also supports the OBI (Open Buying on the Internet) standard for transferring orders. Note: If you deliver order to a non-secure web server (not https) credit card numbers will be masked to ensure data security.

An order in the Yahoo Format consists of key-value pairs, delivered in an HTTP POST request to the specified URL. Example keys are Ship-Name, Card-Number, and Item-Description-1. See the full documentation and example CGI script for details.

The Real-Time Delivery XML option uses the same XML format as the order-notification XML email that you can select in the Email section of your Store Manager.

In this case, however, only one order will be sent. Learn more about our XML format here: Exporting orders as XML. Please note: The XML order delivery option currently does not provide PayPal transaction ID information.

The Open Buying specification. Orders and catalog requests are delivered as OBI Orders (not order requests) to the URLs you specify.

Configure real-time delivery

1. Sign in to your My Services page.
2. Click the Store link.
   
3. Go to Real-Time Links.
   
4. Go to Real-Time Link Settings.
   
5. Under Real Time Delivery, enter the URL of your CGI script to receive Orders or Catalog Requests in the appropriate fields. Example: https://www.widgetdesigns.com/cgi-bin/receive-yahoo-order.
   
6. Select the Include Credit Card Number checkbox if you want full credit numbers posted to your URL (available for https URLs only).
   
7. Select an order Format from the pull-down menu:
   • Yahoo Format - Consists of key-value pairs, delivered in an HTTP POST request to the specified URL. Learn more.
   • ECML - Electronic commerce markup language. Learn more.
   • XML - Uses the same XML format as the order-notification XML email that you can select in the Email section of your Store Manager. Learn more.
   • OBI - Open Buying on the Internet OBI/1.1 protocol. Learn more.
   
8. Choose a delivery rate:
   • Fast Delivery in parallel (default) - Select to receive up to 15 orders at once.
   • One at a time - Select if you will not receive multiple orders at once or if your system has trouble handling multiple orders at once.
   
9. (Optional) Enable Post on Update. Checking this optional settings will trigger a new Post for an order after it is updated or modified in the Order Manager.
    
10. On the top-right or bottom-right, click the Update button.
    
11. Click the Done button.
    
12. Return to Store Manager and publish your Order Settings.
    

The system will try to repost the order to your server every 15 minutes for up to 12 hours. If the posting fails, an error notification email will be sent to the email address entered in the Email field of the Order System Settings page accessed by clicking the Email link in the Order Settings column.

Note: If you require firewall restrictions on access to your web server, add the IP ranges for real-time integrations.

We will add new keys to this format as required to support new features. Software at the receiving end should ignore unrecognized keys.