Retrieve Order

Definition

By order ID or seller order ID:
https://sandbox.bluesnap.com/services/2/orders/:order-id|:seller-order-id,:seller-id

By invoice ID or subscription ID
https://sandbox.bluesnap.com/services/2/orders/resolve?invoiceId={invoice-id}|subscriptionid={subscription-id}


The Retrieve Order request enables you to retrieve details about an order, including the product, quantity, price, invoice details, fulfillment information, and more.

Request Content

Retrieve based on order ID in BlueSnap

Enter the order-id into the web service URL, in the format:
services/2/orders/{order-id}

For example:
services/2/orders/9876543

Retrieve based on seller order ID

Enter the unique ID that you assigned to the order (the seller-order-id), and your seller ID in BlueSnap (seller-id) into the web service URL, in the format:
services/2/orders/{seller-order-id},{seller-id}

For example:
services/2/orders/456789123,111222

Retrieve based on invoice ID

Enter the invoice-id into the web service URL, in the format:
services/2/orders/resolve?invoiceId={invoice-id}

For example:
services/2/orders/resolve?invoiceId=34567

Retrieve based on subscription ID

Enter the subscription ID into the web service URL, in the format:
services/2/orders/resolve?subscriptionid={subscription-id}

For example:
services/2/orders/resolve?subscriptionid=87654

📘

Locating the relevant ID type

Each type of ID above is a different value in BlueSnap. Make sure that you are using the relevant ID in your request. You can find the IDs here:

  • The order ID appears in the order-id field in the response when you create a new order.
  • The invoice ID appears in the invoice-id field when you create a new order.
  • The subscription ID appears in the url field when you create a new subscription.

Response Details

If successful, the response HTTP status code is 200 OK.

The response contains the retrieved order resource (see order).
If the order has been refunded, there will be a separate invoice listed in the response for the original charge and each refund.

For details about possible errors, see: General Errors.


Examples

Request Examples

curl -v -X GET https://sandbox.bluesnap.com/services/2/orders/3906167 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
curl -v -X GET https://sandbox.bluesnap.com/services/2/orders/36642950,391768 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
curl -v -X GET https://sandbox.bluesnap.com/services/2/orders/resolve?invoiceId=38399968 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='
curl -v -X GET https://sandbox.bluesnap.com/services/2/orders/resolve?subscriptionid=39469016 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

Response Examples

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<order xmlns="http://ws.plimus.com">
  <order-id>3906167</order-id>
  <ordering-shopper>
    <shopper-id>19489486</shopper-id>
  </ordering-shopper>
  <cart>
    <charged-currency>USD</charged-currency>
    <cart-item>
      <sku>
        <sku-id>2175514</sku-id>
        <sku-name>TestProduct Gold Edition</sku-name>
      </sku>
      <quantity>1</quantity>
      <item-sub-total>15.00</item-sub-total>
    </cart-item>
    <tax>0.00</tax>
    <tax-rate>0</tax-rate>
    <total-cart-cost>15.00</total-cart-cost>
  </cart>
  <post-sale-info>
    <invoices>
      <invoice>
        <invoice-id>38398826</invoice-id>
        <url>https://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=ECD5940FFEDE3C46</url>
        <financial-transactions>
          <financial-transaction>
            <status>Approved</status>
            <date-due>02-Jul-19</date-due>
            <date-created>02-Jul-19</date-created>
            <amount>15.00</amount>
            <currency>USD</currency>
            <soft-descriptor>BLS*MYCOMPANY</soft-descriptor>
            <payment-method>Credit Card</payment-method>
            <target-balance>ACCOUNT</target-balance>
            <credit-card>
              <card-last-four-digits>1111</card-last-four-digits>
              <card-type>Visa</card-type>
              <card-sub-type>CREDIT</card-sub-type>
              <card-category>CLASSIC</card-category>
              <expiration-month>9</expiration-month>
              <expiration-year>2023</expiration-year>
            </credit-card>
            <paypal-transaction-data/>
            <invoice-contact-info>
              <title>Mr.</title>
              <first-name>John</first-name>
              <last-name>Doe</last-name>
              <email>[email protected]</email>
              <company-name>JohnDoeAndSons</company-name>
              <address1>138 Market St</address1>
              <city>San Francisco</city>
              <state>CA</state>
              <zip>75654</zip>
              <country>US</country>
              <phone>14135556789</phone>
              <fax>141355567898/fax>
            </invoice-contact-info>
            <skus>
              <sku>
                <sku-id>2175514</sku-id>
                <sku-name>TestProduct Gold Edition</sku-name>
              </sku>
            </skus>
          </financial-transaction>
        </financial-transactions>
      </invoice>
    </invoices>
  </post-sale-info>
  <fulfillment>
    <license-keys/>
    <download-links>
      <sku-download-link>
        <sku-id>2175514</sku-id>
        <sku-name>TestProduct Gold Edition</sku-name>
        <download-link>https://sandbox.bluesnap.com/jsp/dlapp.jsp?ref=38398826C2175514C6687830</download-link>
      </sku-download-link>
    </download-links>
  </fulfillment>
</order>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<order xmlns="http://ws.plimus.com">
  <order-id>3979819</order-id>
  <seller-order-id>36642950</seller-order-id>
  <ordering-shopper>
    <shopper-id>19562772</shopper-id>
  </ordering-shopper>
  <cart>
    <charged-currency>USD</charged-currency>
    <cart-item>
      <sku>
        <sku-id>2186520</sku-id>
        <sku-name>recurring</sku-name>
      </sku>
      <quantity>1</quantity>
      <url>https://sandbox.bluesnap.com/services/2/subscriptions/39520970</url>
      <item-sub-total>0.00</item-sub-total>
    </cart-item>
    <tax>0.00</tax>
    <tax-rate>0</tax-rate>
    <total-cart-cost>0.00</total-cart-cost>
  </cart>
  <post-sale-info>
    <invoices>
      <invoice>
        <invoice-id>38502076</invoice-id>
        <url>http://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=25F7796A6577E36D</url>
        <financial-transactions>
          <financial-transaction>
            <status>Approved</status>
            <date-due>12-Nov-19</date-due>
            <date-created>12-Nov-19</date-created>
            <amount>0.00</amount>
            <currency>USD</currency>
            <payment-method>PayPal</payment-method>
            <target-balance>VENDOR_PAYPAL_ACCOUNT</target-balance>
            <paypal-transaction-data>
              <pp-transaction-id>7FL54220CM2536942</pp-transaction-id>
              <pp-subscription-id>I-9CLN2MF8YUUM</pp-subscription-id>
            </paypal-transaction-data>
            <invoice-contact-info>
              <first-name>Bob</first-name>
              <last-name>Bobby</last-name>
              <email>[email protected]</email>
              <address1>1 Main St</address1>
              <city>San Jose</city>
              <state>CA</state>
              <zip>95131</zip>
              <country>us</country>
            </invoice-contact-info>
            <skus>
              <sku>
                <sku-id>2186520</sku-id>
                <sku-name>recurring</sku-name>
              </sku>
            </skus>
          </financial-transaction>
        </financial-transactions>
      </invoice>
    </invoices>
  </post-sale-info>
  <fulfillment>
    <license-keys/>
  </fulfillment>
</order>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<order xmlns="http://ws.plimus.com">
  <order-id>3906167</order-id>
  <ordering-shopper>
    <shopper-id>19489486</shopper-id>
  </ordering-shopper>
  <cart>
    <charged-currency>USD</charged-currency>
    <cart-item>
      <sku>
        <sku-id>2175514</sku-id>
        <sku-name>TestProduct Gold Edition</sku-name>
      </sku>
      <quantity>1</quantity>
      <item-sub-total>15.00</item-sub-total>
    </cart-item>
    <tax>0.00</tax>
    <tax-rate>0</tax-rate>
    <total-cart-cost>15.00</total-cart-cost>
  </cart>
  <post-sale-info>
    <invoices>
      <invoice>
        <invoice-id>38398826</invoice-id>
        <url>https://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=ECD5940FFEDE3C46</url>
        <financial-transactions>
          <financial-transaction>
            <status>Approved</status>
            <date-due>02-Jul-19</date-due>
            <date-created>02-Jul-19</date-created>
            <amount>15.00</amount>
            <currency>USD</currency>
            <soft-descriptor>BLS*MYCOMPANY</soft-descriptor>
            <payment-method>Credit Card</payment-method>
            <target-balance>ACCOUNT</target-balance>
            <credit-card>
              <card-last-four-digits>1111</card-last-four-digits>
              <card-type>Visa</card-type>
              <card-sub-type>CREDIT</card-sub-type>
              <card-category>CLASSIC</card-category>
              <expiration-month>9</expiration-month>
              <expiration-year>2023</expiration-year>
            </credit-card>
            <paypal-transaction-data/>
            <invoice-contact-info>
              <title>Mr.</title>
              <first-name>John</first-name>
              <last-name>Doe</last-name>
              <email>[email protected]</email>
              <company-name>JohnDoeAndSons</company-name>
              <address1>138 Market St</address1>
              <city>San Francisco</city>
              <state>CA</state>
              <zip>75654</zip>
              <country>US</country>
              <phone>14135556789</phone>
              <fax>14135556788</fax>
            </invoice-contact-info>
            <skus>
              <sku>
                <sku-id>2175514</sku-id>
                <sku-name>TestProduct Gold Edition</sku-name>
              </sku>
            </skus>
          </financial-transaction>
        </financial-transactions>
      </invoice>
    </invoices>
  </post-sale-info>
  <fulfillment>
    <license-keys/>
    <download-links>
      <sku-download-link>
        <sku-id>2175514</sku-id>
        <sku-name>TestProduct Gold Edition</sku-name>
        <download-link>https://sandbox.bluesnap.com/jsp/dlapp.jsp?ref=38398826C2175514C6687830</download-link>
      </sku-download-link>
    </download-links>
  </fulfillment>
</order>
<?xml version="1.0" encoding="UTF-8"?>
<order xmlns="http://ws.plimus.com">
  <order-id>3923051</order-id>
  <ordering-shopper>
    <shopper-id>19505364</shopper-id>
    <seller-shopper-id>987654321</seller-shopper-id>
  </ordering-shopper>
  <cart>
    <charged-currency>USD</charged-currency>
    <cart-item>
      <sku>
        <sku-id>2178834</sku-id>
        <sku-name>Contract Example</sku-name>
      </sku>
      <quantity>1</quantity>
      <url>https://sandbox.bluesnap.com/services/2/subscriptions/39469016</url>
      <item-sub-total>5.00</item-sub-total>
    </cart-item>
    <tax>0.00</tax>
    <tax-rate>0</tax-rate>
    <total-cart-cost>5.00</total-cart-cost>
  </cart>
  <post-sale-info>
    <invoices>
      <invoice>
        <invoice-id>38420528</invoice-id>
        <url>http://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=A29AC4EA01AA732F</url>
        <financial-transactions>
          <financial-transaction>
            <status>Approved</status>
            <date-due>26-Aug-18</date-due>
            <date-created>26-Aug-18</date-created>
            <amount>5.00</amount>
            <currency>USD</currency>
            <soft-descriptor>BLS*DescTest</soft-descriptor>
            <payment-method>Credit Card</payment-method>
            <target-balance>ACCOUNT</target-balance>
            <credit-card>
              <card-last-four-digits>1111</card-last-four-digits>
              <card-type>Visa</card-type>
              <card-sub-type>DEBIT</card-sub-type>
              <expiration-month>9</expiration-month>
              <expiration-year>2023</expiration-year>
            </credit-card>
            <paypal-transaction-data />
            <invoice-contact-info>
              <title>Mr.</title>
              <first-name>John</first-name>
              <last-name>Doe</last-name>
              <email>[email protected]</email>
              <company-name>JohnDoeAndSons</company-name>
              <address1>138 Market St</address1>
              <city>San Francisco</city>
              <state>CA</state>
              <zip>75654</zip>
              <country>US</country>
              <phone>14135556789</phone>
              <fax>14135556788</fax>
            </invoice-contact-info>
            <skus>
              <sku>
                <sku-id>2178834</sku-id>
              </sku>
            </skus>
          </financial-transaction>
        </financial-transactions>
      </invoice>
      <invoice>
        <invoice-id>38420530</invoice-id>
        <url>http://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=F293E0FA74B9EED5</url>
        <financial-transactions>
          <financial-transaction>
            <status>Approved</status>
            <date-due>26-Aug-19</date-due>
            <date-created>26-Aug-19</date-created>
            <amount>-5.00</amount>
            <currency>USD</currency>
            <payment-method>Credit Card</payment-method>
            <target-balance>ACCOUNT</target-balance>
            <credit-card>
              <card-last-four-digits>1111</card-last-four-digits>
              <card-type>Visa</card-type>
              <card-sub-type>DEBIT</card-sub-type>
              <expiration-month>9</expiration-month>
              <expiration-year>2023</expiration-year>
            </credit-card>
            <paypal-transaction-data />
            <invoice-contact-info>
              <title>Mr.</title>
              <first-name>John</first-name>
              <last-name>Doe</last-name>
              <email>[email protected]</email>
              <company-name>JohnDoeAndSons</company-name>
              <address1>138 Market St</address1>
              <city>San Francisco</city>
              <state>CA</state>
              <zip>75654</zip>
              <country>US</country>
              <phone>14135556789</phone>
              <fax>14135556788</fax>
            </invoice-contact-info>
            <skus>
              <sku>
                <sku-id>2178834</sku-id>
                <sku-name>Contract Example</sku-name>
              </sku>
            </skus>
          </financial-transaction>
        </financial-transactions>
      </invoice>
    </invoices>
  </post-sale-info>
  <fulfillment>
    <license-keys />
  </fulfillment>
</order>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<order xmlns="http://ws.plimus.com">
    <order-id>3906915</order-id>
    <seller-order-id>1234567890</seller-order-id>
    <ordering-shopper>
        <shopper-id>19990000</shopper-id>
    </ordering-shopper>
    <cart>
        <charged-currency>EUR</charged-currency>
        <cart-item>
            <sku>
                <sku-id>2181378</sku-id>
                <sku-name>Contract 1</sku-name>
            </sku>
            <quantity>1</quantity>
            <item-sub-total>99.99</item-sub-total>
        </cart-item>
        <tax>0.00</tax>
        <tax-rate>0</tax-rate>
        <total-cart-cost>99.99</total-cart-cost>
    </cart>
    <post-sale-info>
        <invoices>
            <invoice>
                <invoice-id>38417916</invoice-id>
                <url>https://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=DAEF2E3</url>
                <financial-transactions>
                    <financial-transaction>
                        <status>Approved</status>
                        <date-due>13-Sep-19</date-due>
                        <date-created>13-Sep-19</date-created>
                        <amount>99.99</amount>
                        <currency>EUR</currency>
                        <soft-descriptor>BLS&#x2a;DescTest1234567</soft-descriptor>
                        <payment-method>Credit Card</payment-method>
                        <target-balance>ACCOUNT</target-balance>
                        <credit-card>
                            <card-last-four-digits>1111</card-last-four-digits>
                            <card-type>Visa</card-type>
                            <card-sub-type>CREDIT</card-sub-type>
                            <card-category>CLASSIC</card-category>
                            <expiration-month>9</expiration-month>
                            <expiration-year>2023</expiration-year>
                        </credit-card>
                        <paypal-transaction-data/>
                        <invoice-contact-info>
                            <first-name>John</first-name>
                            <last-name>Doe</last-name>
                            <email>jdoe&#x40;johndoeandsons.com</email>
                            <address1>138 Market st</address1>
                            <city>San Francisco</city>
                            <zip>756543</zip>
                            <country>fr</country>
                            <phone>1413555666</phone>
                        </invoice-contact-info>
                        <skus>
                            <sku>
                                <sku-id>2181378</sku-id>
                            </sku>
                        </skus>
                    </financial-transaction>
                </financial-transactions>
            </invoice>
            <invoice>
                <invoice-id>38417918</invoice-id>
                <original-invoice-id>38417916</original-invoice-id>
                <url>https://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=8F1F5FECB</url>
                <financial-transactions>
                    <financial-transaction>
                        <status>Approved</status>
                        <date-due>13-Sep-19</date-due>
                        <date-created>13-Sep-19</date-created>
                        <amount>-55.55</amount>
                        <currency>EUR</currency>
                        <payment-method>Credit Card</payment-method>
                        <target-balance>ACCOUNT</target-balance>
                        <credit-card>
                            <card-last-four-digits>1111</card-last-four-digits>
                            <card-type>Visa</card-type>
                            <card-sub-type>CREDIT</card-sub-type>
                            <card-category>CLASSIC</card-category>
                            <expiration-month>9</expiration-month>
                            <expiration-year>2023</expiration-year>
                        </credit-card>
                        <paypal-transaction-data/>
                        <invoice-contact-info>
                            <first-name>John</first-name>
                            <last-name>Doe</last-name>
                            <email>jdoe&#x40;johndoeandsons.com</email>
                            <address1>138 Market st</address1>
                            <city>San Francisco</city>
                            <zip>756543</zip>
                            <country>fr</country>
                            <phone>1413555666</phone>
                        </invoice-contact-info>
                        <skus>
                            <sku>
                                <sku-id>2181378</sku-id>
                                <sku-name>Contract 1</sku-name>
                            </sku>
                        </skus>
                    </financial-transaction>
                </financial-transactions>
            </invoice>
            <invoice>
                <invoice-id>38417920</invoice-id>
                <original-invoice-id>38417916</original-invoice-id>
                <url>https://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=335F0843E</url>
                <financial-transactions>
                    <financial-transaction>
                        <status>Approved</status>
                        <date-due>13-Sep-19</date-due>
                        <date-created>13-Sep-19</date-created>
                        <amount>-44.44</amount>
                        <currency>EUR</currency>
                        <payment-method>Credit Card</payment-method>
                        <target-balance>ACCOUNT</target-balance>
                        <credit-card>
                            <card-last-four-digits>1111</card-last-four-digits>
                            <card-type>Visa</card-type>
                            <card-sub-type>CREDIT</card-sub-type>
                            <card-category>CLASSIC</card-category>
                            <expiration-month>9</expiration-month>
                            <expiration-year>2023</expiration-year>
                        </credit-card>
                        <paypal-transaction-data/>
                        <invoice-contact-info>
                            <first-name>John</first-name>
                            <last-name>Doe</last-name>
                            <email>jdoe&#x40;johndoeandsons.com</email>
                            <address1>138 Market st</address1>
                            <city>San Francisco</city>
                            <zip>756543</zip>
                            <country>fr</country>
                            <phone>1413555666</phone>
                        </invoice-contact-info>
                        <skus>
                            <sku>
                                <sku-id>2181378</sku-id>
                                <sku-name>Contract 1</sku-name>
                            </sku>
                        </skus>
                    </financial-transaction>
                </financial-transactions>
            </invoice>
        </invoices>
    </post-sale-info>
    <fulfillment>
        <license-keys/>
    </fulfillment>
</order>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<order xmlns="http://ws.plimus.com">
  <order-id>3906167</order-id>
  <ordering-shopper>
    <shopper-id>19489486</shopper-id>
  </ordering-shopper>
  <cart>
    <charged-currency>USD</charged-currency>
    <cart-item>
      <sku>
        <sku-id>2175514</sku-id>
        <sku-name>TestProduct Gold Edition</sku-name>
      </sku>
      <quantity>1</quantity>
      <item-sub-total>15.00</item-sub-total>
    </cart-item>
    <tax>0.00</tax>
    <tax-rate>0</tax-rate>
    <total-cart-cost>15.00</total-cart-cost>
  </cart>
  <post-sale-info>
    <invoices>
      <invoice>
        <invoice-id>38398826</invoice-id>
        <url>https://sandbox.bluesnap.com/jsp/show_invoice.jsp?ref=ECD5940FFEDE3C46</url>
        <financial-transactions>
          <financial-transaction>
            <status>Approved</status>
            <date-due>02-Jul-19</date-due>
            <date-created>02-Jul-19</date-created>
            <amount>15.00</amount>
            <currency>USD</currency>
            <soft-descriptor>BLS*MYCOMPANY</soft-descriptor>
            <payment-method>Credit Card</payment-method>
            <target-balance>ACCOUNT</target-balance>
            <credit-card>
              <card-last-four-digits>1111</card-last-four-digits>
              <card-type>Visa</card-type>
              <card-sub-type>CREDIT</card-sub-type>
              <card-category>CLASSIC</card-category>
              <expiration-month>9</expiration-month>
              <expiration-year>2023</expiration-year>
            </credit-card>
            <paypal-transaction-data/>
            <invoice-contact-info>
              <title>Mr.</title>
              <first-name>John</first-name>
              <last-name>Doe</last-name>
              <email>[email protected]</email>
              <company-name>JohnDoeAndSons</company-name>
              <address1>138 Market St</address1>
              <city>San Francisco</city>
              <state>CA</state>
              <zip>75654</zip>
              <country>US</country>
              <phone>14135556789</phone>
              <fax>141355567898/fax>
            </invoice-contact-info>
     				<authorization-code>654321</authorization-code>
            <skus>
              <sku>
                <sku-id>2175514</sku-id>
                <sku-name>TestProduct Gold Edition</sku-name>
              </sku>
            </skus>
          </financial-transaction>
        </financial-transactions>
      </invoice>
    </invoices>
  </post-sale-info>
  <fulfillment>
    <license-keys/>
    <download-links>
      <sku-download-link>
        <sku-id>2175514</sku-id>
        <sku-name>TestProduct Gold Edition</sku-name>
        <download-link>https://sandbox.bluesnap.com/jsp/dlapp.jsp?ref=38398826C2175514C6687830</download-link>
      </sku-download-link>
    </download-links>
  </fulfillment>
</order>

Back to Top