Order Callback Request Schema
The order callback requests you received from Subscribe Pro will contain full details about the order which is to be placed.
Property | Details |
---|---|
allowSomeFailedItems bool | Allow Some Failed Items Default: false The Subscribe Pro environment where this order was triggered is configured to allow partial orders - order attempts where at least 1 subscription item failed to be ordered and at least 1 item was successfully ordered. |
customerId (required)string | Subscribe Pro Customer ID |
customerEmail (required)string | Customer Email |
platformCustomerId (required)string | eCommerce Platform Customer ID |
salesOrderToken string | Sales Order Token This is a unique token provided by Subscribe Pro when placing an order. It uniquely represents this request. Pass this token back to Subscribe Pro if it is necessary to make any API requests back to Subscribe Pro during the order placement process. |
shippingMethodCode string | Shipping Method Code Code that represents which shipping carrier and method should be used for this order. Example: "flat_rate" , "free_shipping" OR "ups_ground" |
currency (required)string | Currency Code 3 Digit ISO Currency Code. Example: "USD" |
payment (required)object | Payment Details Payment details specifying how this order should be paid. |
payment.paymentToken string | Payment Token Unique payment token that represents the payment method or payment profile which should be used to pay for this order. |
payment.thirdPartyPaymentToken string | Third Party Payment Token Unique payment token from third-party payment provider or gateway. |
payment.paymentVaultCustomerToken string | Payment Vault Customer Token Unique customer token from third-party payment provider or gateway |
payment.paymentProfileId string | Subscribe Pro Payment Profile ID Unique ID of a Subscribe Pro payment profile which should be used to pay for this order. |
payment.paymentProfileType string | Subscribe Pro Payment Profile Type Type of a Subscribe Pro payment profile which should be used to pay for this order. See: GET /services/v2/vault/paymentprofiles/{id} |
payment.paymentMethodType string | Subscribe Pro Payment Method Type Type of payment method for payment profile. Example: "creditcard" |
payment.creditcardType string | Credit Card Type One of: "visa" , "master" , "discover" , "american_express" , etc |
payment.creditcardMonth string | Credit Card Expiration Month 2 digit expiration date month. |
payment.creditcardYear string | Credit Card Expiration Year 4 digit expiration date year. |
payment.creditcardLastDigits string | Credit Card Last Digits Last 4 digits of card number that are safe to display. |
couponCodes array | Coupon Codes Array of coupon codes (string). These are listed in priority order and should be applied to the cart which is generated in this order. |
billingAddress (required)object | Billing Address Customer's billing address associated with the order. |
billingAddress.firstName (required)string | First Name |
billingAddress.lastName (required)string | Last Name |
billingAddress.company string | Company Company name associated with the address |
billingAddress.street1 string | Street Address Line 1 |
billingAddress.street2 string | Street Address Line 2 |
billingAddress.city string | City |
billingAddress.region string | Region Region, state or province |
billingAddress.postcode string | Postcode |
billingAddress.country string | Country Country name, code or abbreviation |
billingAddress.countryName string | Country Name |
billingAddress.phone string | Phone The phone number associated with the address. |
shippingAddress object | Shipping Address Customer's shipping address associated with the order. |
shippingAddress.firstName string | First Name |
shippingAddress.lastName string | Last Name |
shippingAddress.company string | Company Company name associated with the address |
shippingAddress.street1 string | Street Address Line 1 |
shippingAddress.street2 string | Street Address Line 2 |
shippingAddress.city string | City |
shippingAddress.region string | Region Region, state or province |
shippingAddress.postcode string | Postcode |
shippingAddress.country string | Country Country name, code or abbreviation |
shippingAddress.countryName string | Country Name |
shippingAddress.phone string | Phone The phone number associated with the address. |
items (required)array | Items Array of order line items for this order. |
items[].productSku (required)string | Product SKU The product SKU should be used to uniquely identify which product to order for this line item. |
items[].shortDescription string | Line Item Short Description This is the line item description for display on order emails, invoices, packing slips, etc. |
items[].qty (required)string | Quantity Quantity for the line item. Example: "2.00" |
items[].requiresShipping boolean | Requires Shipping Default: true Does this line item require shipping to the customer? |
items[].useFixedPrice bool | Use Fixed Price Default: false Should a fixed price be used for this item? |
items[].fixedPrice string | Fixed Price Fixed price (unit price) to use for this line item. This price should override any pricing that would otherwise be calculated by the handling system. Example: "30.2000" |
items[].subscription object | Subscription Details about the Subscribe Pro subscription record which is being ordered with this line item. |
items[].subscription.id string | Subscription ID Subscribe Pro subscription ID of the subscription item which is associated with this line item. |
items[].subscription.interval string | Current Subscription Frequency Interval The current frequency interval set on the subscription item at the time order was requested. |
items[].subscription.scheduleName string | Current Subscription Schedule Name The current schedule name of the schedule set on the subscription item at the time order was requested. |
items[].subscription.reorderOrdinal string | Current Subscription Reorder Ordinal The current order will represent the Nth order against this subscription item. |
items[].subscription.nextOrderDate string | Subscription Next Order Date The expected next order date for this subscription item (assuming the current order is successful). |
items[].subscription.userDefinedFields array | Subscription User Defined Fields An array of user defined fields which are currently stored on the subscription item. |
items[].subscription.magento2ProductOptions array | Magento 2 Product Options In the case that the order callback is used with a Magento 2 integration, this field contains an array of Magento 2 product options data which is stored on the subscription item. |