Delivery Report API Payload and Examples
| Field | Mandatory? | Description |
|---|---|---|
| merchant | Yes | Fields describing the merchant. |
| .id | Yes | Merchant identifier. Also called merchant_ref. Example: "s1". (string or int) |
| orders | Yes | Orders delivered during the previous period. |
| .0.state | Yes | String containing state of the order. Should be 'shipped' or 'delivered'. Example: "shipped". (string) |
| .0.sent_at | No | When this order was processed in the shop system. Used to detect if an order is shipped more than once. Example: "2014-02-05T19:21:22+01:00". (string) |
| .0.merchant_reference | Yes | Order id(s) used by the merchant |
| .0.merchant_reference.order_ref_1 | Yes | Merchant reference 1. Example: "ZXCV1234". (string or int) |
| .0.merchant_reference.order_ref_2 | No | Merchant reference 2. Example: "0080-1234-4343-5353". (string or int) |
| .0.cart | Yes | Fields describing the shopping cart. |
| .0.cart.currency | Yes | Name of currency used on the purchase. Example: "EUR". (string) |
| .0.cart.gift | Yes | Set to true if shopper has indicated that this is a gift. Example: false. (true or false) |
| .0.cart.order_total_with_tax | Yes | Total value with tax of the items listed below. Example: 6097. (int) |
| .0.cart.cart_ref | No | Shop's unique id for this basket. Useful if shopper has trouble checking out. Example: "123". (string or int) |
| .0.cart.subscription_period | No | Minimum duration of the subscription (in months), from the date of activation of subscription. Example: 24. (positive int) |
| .0.cart.subscription_total_price | No | Total monthly cost of the subscription of the items listed below. Example: 1000. (positive int) |
| .0.cart.created_at | No | When shopper put the first item in the cart. Example: "2013-10-18T12:25:20+01:00". (string) |
| .0.cart.updated_at | No | When shopper put the last item in the cart. Example: "2013-10-18T12:25:20+01:00". (string) |
| .0.cart.items | Yes | List of items in the order. The list can contain zero or more instances of each item type. (list) |
| The lines starting with orders.0.cart.items.0 describe the API when orders.0.cart.items.0.type is 'product' or missing. | ||
| .0.cart.items.0.reference | Yes | A public product id for this item. Example: "12-123-1234". (string or int) |
| .0.cart.items.0.name | Yes | A description to include in the payment instructions. Example: "Leather Case (iPod nano) - Negro / Chocolate". (string) |
| .0.cart.items.0.price_with_tax | Yes | Price with tax for one item. Example: 3030. (int) |
| .0.cart.items.0.quantity | Yes | The number of items ordered by the shopper. Example: 2. (int) |
| .0.cart.items.0.subscription_period | No | Subscription period of item in months. Example: 24. (positive int) |
| .0.cart.items.0.subscription_price_per_item | No | Subscription cost per month per item. Example: 500. (positive int) |
| .0.cart.items.0.subscription_price | No | Total subscription cost per month (subscription_price_per_item * quantity) Example: 1000. (positive int) |
| .0.cart.items.0.subscription_vat_rate | No | VAT rate for subscription (multiplied by 100: 2100 for 21%). Example: 2100. (positive int) |
| .0.cart.items.0.total_with_tax | Yes | Price with tax for the amount in the order. Due to rounding, this might not be exactly quantity × price_with_tax. Example: 6060. (int) |
| .0.cart.items.0.downloadable | Yes | Can the buyer access or consume the product without a physical delivery? PDFs, e-tickets, software, etc are downloadable. Example: false. (true or false) |
| .0.cart.items.0.perishable | No | A product is perishable if it loses its value if it is not delivered on time. Examples are fresh fruit and physical tickets. Example: false. (true or false) |
| .0.cart.items.0.personalized | No | A product is personalized if it is irreversibly customized in a way that makes it less appealing to most people other than the buyer. Example: false. (true or false) |
| .0.cart.items.0.restockable | No | A product is restockable if it can be sold to someone else if returned in good condition. Foodstuff is generally not restockable. Example: true. (true or false) |
| .0.cart.items.0.category | No | Name of category. Will not be shown to shopper. Useful against fraud. Example: "ipod-accesorios". (string) |
| .0.cart.items.0.description | No | Product description. Will not be shown to shopper. Useful against fraud. Example: "Este estuche de cuero de última moda ...". (string) |
| .0.cart.items.0.manufacturer | No | Name of manufacturer. Will not be shown to shopper. Useful against fraud. Example: "Apple". (string) |
| .0.cart.items.0.supplier | No | Name of supplier or provider. Will not be shown to shopper. Useful against fraud. Example: "Mayorista Makro". (string) |
| .0.cart.items.0.product_id | No | Id from database. Will not be shown to shopper. Sometimes useful if 'reference' varies too much over time. Example: "6". (string or int) |
| .0.cart.items.0.url | No | Product page URL in your shop. Might be shown to shopper. Useful for customer service. Example: "http://shop.example.com/ipod-accesorios/leather-case". (string) |
| .0.cart.items.0.tracking_reference | No | A reference to the tracking in which this item will be handed. Example: "first". (string) |
| The lines starting with orders.0.cart.items.1 describe the API when orders.0.cart.items.1.type is 'handling'. Note that keys "quantity" and "price_with_tax" are not allowed in this section. |
||
| .0.cart.items.1.reference | Yes | A unique code that refers to this item. Does not have to exist in the shop catalogue. Example: "seur24". (string or int) |
| .0.cart.items.1.name | Yes | A name to describe this item. More specific is better, i.e. prefer 'Correos' to 'Envío'. Example: "SEUR entrega en 24 horas". (string) |
| .0.cart.items.1.total_with_tax | Yes | Price with tax for this handling service. Example: 242. (int) |
| The lines starting with orders.0.cart.items.2 describe the API when orders.0.cart.items.2.type is 'invoice_fee'. Note that keys "quantity" and "price_with_tax" are not allowed in this section. |
||
| .0.cart.items.2.total_with_tax | Yes | Price with tax for the invoice (i1) service. Do not use with product codes other than i1. Example: 295. (int) |
| The lines starting with orders.0.cart.items.3 describe the API when orders.0.cart.items.3.type is 'discount'. Note that keys "quantity" and "price_with_tax" are not allowed in this section. |
||
| .0.cart.items.3.reference | Yes | A unique code that refers to this discount. Can be the discount code. Example: "HALFOFF". (string or int) |
| .0.cart.items.3.name | Yes | A name to describe this discount. Might be displayed in the payment instructions. Example: "50 % off the full basket!". (string) |
| .0.cart.items.3.total_with_tax | Yes | Amount that this discount changes the cart value with tax. Should be negative. Example: -750. (negative int) |
| The lines starting with orders.0.cart.items.4 describe the API when orders.0.cart.items.4.type is 'other_payment'. Note that keys "quantity" and "price_with_tax" are not allowed in this section. |
||
| .0.cart.items.4.reference | Yes | A code that refers to this "other" payment. (An "other" payment means that the shopper " \ "has paid part of the cart using some other means of payment, like cash or credit card.) Example: "CASH". (string or int) |
| .0.cart.items.4.name | Yes | A name to describe this payment. Example: "Paid in cash". (string) |
| .0.cart.items.4.total_with_tax | Yes | Amount that this payment changes the cart value with tax. Should use opposite sign of any item it pays for. Example: -750. (negative int) |
| The lines starting with orders.0.cart.items.5 describe the API when orders.0.cart.items.5.type is 'service'. | ||
| .0.cart.items.5.reference | Yes | A public id for this service. Example: "NETWORKS-ADMIN-101". (string or int) |
| .0.cart.items.5.name | Yes | A name to describe this service. Might be displayed in the payment instructions. Example: "Networks Administrator Course". (string) |
| .0.cart.items.5.ends_on | Yes | Maximum date for the service to be rendered or ended. Example: "2017-06-30". (ISO8601 formatted date) |
| .0.cart.items.5.ends_in | Yes | Maximum time, from the start of the service, for the service to be rendered or ended. Example: "P3M15D". (ISO8601 formatted period) |
| .0.cart.items.5.price_with_tax | Yes | Price with tax for one item. Example: 3030. (int) |
| .0.cart.items.5.quantity | Yes | The number of items ordered by the shopper. Example: 1. (positive int) |
| .0.cart.items.5.total_with_tax | Yes | Price with tax for the amount in the order. Due to rounding, this might not be exactly quantity × price_with_tax. Example: 75020. (int) |
| .0.cart.items.5.downloadable | Yes | True for services that can be fully (or sufficiently) enjoyed without a physical delivery. For instance, a course with only digital material. Example: false. (true or false) |
| .0.cart.items.5.supplier | No | Name of supplier or provider. Example: "Acme Formación". (string) |
| .0.cart.items.5.rendered | No | True when the service has been rendered Example: false. (true or false) |
| The lines starting with orders.0.cart.items.9 describe the API when orders.0.cart.items.9.type is 'subscriber_fee'. | ||
| .0.cart.items.9.reference | No | A public product id for this item. Example: "12-123-1234". (string or int) |
| .0.cart.items.9.name | Yes | A description to include in the payment instructions. Example: "Subscription fee". (string) |
| .0.cart.items.9.price_with_tax | No | Price with tax for one item. Example: 3030. (int) |
| .0.cart.items.9.quantity | No | The number of items ordered by the shopper. Example: 2. (positive int) |
| .0.cart.items.9.subscription_period | No | Subscription period of item in months. Example: 24. (positive int) |
| .0.cart.items.9.subscription_price_per_item | No | Subscription cost per month per item. Example: 500. (positive int) |
| .0.cart.items.9.subscription_price | No | Total subscription cost per month (subscription_price_per_item * quantity) Example: 1000. (positive int) |
| .0.cart.items.9.subscription_vat_rate | No | VAT rate for subscription (multiplied by 100: 2100 for 21%). Example: 2100. (positive int) |
| .0.cart.items.9.total_with_tax | Yes | Price with tax for the amount in the order. Due to rounding, this might not be exactly quantity × price_with_tax. Example: 6060. (int) |
| The lines starting with orders.0.cart.items.10 describe the API when orders.0.cart.items.10.type is 'voucher'. Note that keys "quantity" and "price_with_tax" are not allowed in this section. |
||
| .0.cart.items.10.reference | Yes | A code that refers to this voucher. Can be the voucher code. Example: "NoCashBack". (string or int) |
| .0.cart.items.10.name | Yes | A text to describe this voucher. Might be displayed in the payment instructions. Example: "A voucher for your non-shipped items". (string) |
| .0.cart.items.10.total_with_tax | Yes | Amount that this voucher changes the cart value with tax. Example: 1000. (int) |
| .0.trackings | No | A list of trackings for the order. (list) |
| The lines starting with orders.0.trackings.0 describe the API when orders.0.trackings.0.type is 'pickup_store'. | ||
| .0.trackings.0.reference | Yes | Internal tracking reference. Example: "first". (string) |
| .0.trackings.0.operator_ref | No | Permanent identifier for the operator that handed the delivery. Example: "123-009". (string) |
| .0.trackings.0.store_ref | No | Permanent identifier for the store that handled this delivery. Example: "maquinista". (string) |
| .0.trackings.0.tracking_number | No | Tracking number. Example: "AB331". (string) |
| .0.trackings.0.available_at | No | When this delivery was available in the store. Example: "2014-02-05T13:21:22+01:00". (ISO8601 formatted timestamp) |
| .0.trackings.0.delivered_at | No | When this delivery was handed. When set, the delivey is considered to be handed. Example: "2014-02-05T19:21:22+01:00". (ISO8601 formatted timestamp) |
| .0.trackings.0.address_line_1 | No | Address line 1 for the store. Example: "1600 Pennsylvania Avenue". (string) |
| .0.trackings.0.address_line_2 | No | Address line 2 for the store. Example: "5º". (string) |
| .0.trackings.0.postal_code | No | Postal code. Example: "08013". (string) |
| .0.trackings.0.city | No | City. Example: "Barcelona". (string) |
| .0.trackings.0.state | No | State or region. Example: "Barcelona". (string) |
| .0.trackings.0.country_code | No | Country code. Example: "ES". (ISO-3166 alpha-2/3 code) |
| The lines starting with orders.0.trackings.1 describe the API when orders.0.trackings.1.type is 'pickup_point'. | ||
| .0.trackings.1.reference | Yes | Tracking reference. Example: "second". (string) |
| .0.trackings.1.operator_ref | No | Permanent identifier for the operator that handed the delivery. Example: "123-009". (string) |
| .0.trackings.1.store_ref | No | Permanent identifier for the store that handled this delivery. Example: "maquinista". (string) |
| .0.trackings.1.tracking_number | No | Tracking number. Example: "AB331". (string) |
| .0.trackings.1.available_at | No | When this delivery was available in the store. Example: "2014-02-05T13:21:22+01:00". (ISO8601 formatted timestamp) |
| .0.trackings.1.delivered_at | No | When this delivery was handed. When set, the delivey is considered to be handed. Example: "2014-02-05T19:21:22+01:00". (ISO8601 formatted timestamp) |
| .0.trackings.1.address_line_1 | No | Address line 1 for the pickup point. Example: "1600 Pennsylvania Avenue". (string) |
| .0.trackings.1.address_line_2 | No | Address line 2 for the pickup point. Example: "5º". (string) |
| .0.trackings.1.postal_code | No | Postal code. Example: "08013". (string) |
| .0.trackings.1.city | No | City. Example: "Barcelona". (string) |
| .0.trackings.1.state | No | State or region. Example: "Barcelona". (string) |
| .0.trackings.1.country_code | No | Country code. Example: "ES". (ISO-3166 alpha-2/3 code) |
| The lines starting with orders.0.trackings.2 describe the API when orders.0.trackings.2.type is 'postal'. | ||
| .0.trackings.2.reference | Yes | Internal tracking reference. Example: "third". (string) |
| .0.trackings.2.carrier | Yes | The name of the company that handled this delivery. Example: "SEUR". (string) |
| .0.trackings.2.tracking_number | No | Tracking number. Example: "TX123". (string) |
| .0.trackings.2.tracking_url | No | Tracking URL. Example: "https://logistics.es/TX123". (an HTTPS URL string) |
| .0.trackings.2.delivered_at | No | When this delivery was handed. When set, the delivey is considered to be handed. Example: "2014-02-05T19:21:22+01:00". (ISO8601 formatted timestamp) |
| .0.remaining_cart | No | Items that will be shipped later as part of this order. If this section is missing, it will be calculated based on the original order which sometimes gives confusing results. |
| .0.remaining_cart.order_total_with_tax | Yes | Total value of the remaining items with tax. Example: 5847. (int) |
| .0.remaining_cart.items | Yes | List of remaining items in the order. The list can contain zero or more instances of each item type. (list) |
| The lines starting with orders.0.remaining_cart.items.0 describe the API when orders.0.remaining_cart.items.0.type is 'product' or missing. | ||
| .0.remaining_cart.items.0.reference | Yes | A public product id for this item. Example: "12-123-1234". (string or int) |
| .0.remaining_cart.items.0.name | Yes | A description to include in the payment instructions. Example: "Leather Case (iPod nano) - Negro / Chocolate". (string) |
| .0.remaining_cart.items.0.price_with_tax | Yes | Price with tax for one item. Example: 3030. (int) |
| .0.remaining_cart.items.0.quantity | Yes | The number of items ordered by the shopper. Example: 2. (int) |
| .0.remaining_cart.items.0.subscription_period | No | Subscription period of item in months. Example: 24. (positive int) |
| .0.remaining_cart.items.0.subscription_price_per_item | No | Subscription cost per month per item. Example: 500. (positive int) |
| .0.remaining_cart.items.0.subscription_price | No | Total subscription cost per month (subscription_price_per_item * quantity) Example: 1000. (positive int) |
| .0.remaining_cart.items.0.subscription_vat_rate | No | VAT rate for subscription (multiplied by 100: 2100 for 21%). Example: 2100. (positive int) |
| .0.remaining_cart.items.0.total_with_tax | Yes | Price with tax for the amount in the order. Due to rounding, this might not be exactly quantity × price_with_tax. Example: 6060. (int) |
| .0.remaining_cart.items.0.downloadable | Yes | Can the buyer access or consume the product without a physical delivery? PDFs, e-tickets, software, etc are downloadable. Example: false. (true or false) |
| .0.remaining_cart.items.0.perishable | No | A product is perishable if it loses its value if it is not delivered on time. Examples are fresh fruit and physical tickets. Example: false. (true or false) |
| .0.remaining_cart.items.0.personalized | No | A product is personalized if it is irreversibly customized in a way that makes it less appealing to most people other than the buyer. Example: false. (true or false) |
| .0.remaining_cart.items.0.restockable | No | A product is restockable if it can be sold to someone else if returned in good condition. Foodstuff is generally not restockable. Example: true. (true or false) |
| .0.remaining_cart.items.0.category | No | Name of category. Will not be shown to shopper. Useful against fraud. Example: "ipod-accesorios". (string) |
| .0.remaining_cart.items.0.description | No | Product description. Will not be shown to shopper. Useful against fraud. Example: "Este estuche de cuero de última moda ...". (string) |
| .0.remaining_cart.items.0.manufacturer | No | Name of manufacturer. Will not be shown to shopper. Useful against fraud. Example: "Apple". (string) |
| .0.remaining_cart.items.0.supplier | No | Name of supplier or provider. Will not be shown to shopper. Useful against fraud. Example: "Mayorista Makro". (string) |
| .0.remaining_cart.items.0.product_id | No | Id from database. Will not be shown to shopper. Sometimes useful if 'reference' varies too much over time. Example: "6". (string or int) |
| .0.remaining_cart.items.0.url | No | Product page URL in your shop. Might be shown to shopper. Useful for customer service. Example: "http://shop.example.com/ipod-accesorios/leather-case". (string) |
| .0.remaining_cart.items.0.tracking_reference | No | A reference to the tracking in which this item will be handed. Example: "first". (string) |
| The lines starting with orders.0.remaining_cart.items.1 describe the API when orders.0.remaining_cart.items.1.type is 'handling'. Note that keys "quantity" and "price_with_tax" are not allowed in this section. |
||
| .0.remaining_cart.items.1.reference | Yes | A unique code that refers to this item. Does not have to exist in the shop catalogue. Example: "seur24". (string or int) |
| .0.remaining_cart.items.1.name | Yes | A name to describe this item. More specific is better, i.e. prefer 'Correos' to 'Envío'. Example: "SEUR entrega en 24 horas". (string) |
| .0.remaining_cart.items.1.total_with_tax | Yes | Price with tax for this handling service. Example: 242. (int) |
| The lines starting with orders.0.remaining_cart.items.2 describe the API when orders.0.remaining_cart.items.2.type is 'invoice_fee'. Note that keys "quantity" and "price_with_tax" are not allowed in this section. |
||
| .0.remaining_cart.items.2.total_with_tax | Yes | Price with tax for the invoice (i1) service. Do not use with product codes other than i1. Example: 295. (int) |
| The lines starting with orders.0.remaining_cart.items.3 describe the API when orders.0.remaining_cart.items.3.type is 'discount'. Note that keys "quantity" and "price_with_tax" are not allowed in this section. |
||
| .0.remaining_cart.items.3.reference | Yes | A unique code that refers to this discount. Can be the discount code. Example: "HALFOFF". (string or int) |
| .0.remaining_cart.items.3.name | Yes | A name to describe this discount. Might be displayed in the payment instructions. Example: "50 % off the full basket!". (string) |
| .0.remaining_cart.items.3.total_with_tax | Yes | Amount that this discount changes the cart value with tax. Should be negative. Example: -750. (negative int) |
| The lines starting with orders.0.remaining_cart.items.4 describe the API when orders.0.remaining_cart.items.4.type is 'service'. | ||
| .0.remaining_cart.items.4.reference | Yes | A public id for this service. Example: "NETWORKS-ADMIN-101". (string or int) |
| .0.remaining_cart.items.4.name | Yes | A name to describe this service. Might be displayed in the payment instructions. Example: "Networks Administrator Course". (string) |
| .0.remaining_cart.items.4.ends_on | Yes | Maximum date for the service to be rendered or ended. Example: "2017-06-30". (ISO8601 formatted date) |
| .0.remaining_cart.items.4.ends_in | Yes | Maximum time, from the start of the service, for the service to be rendered or ended. Example: "P3M15D". (ISO8601 formatted period) |
| .0.remaining_cart.items.4.price_with_tax | Yes | Price with tax for one item. Example: 3030. (int) |
| .0.remaining_cart.items.4.quantity | Yes | The number of items ordered by the shopper. Example: 1. (positive int) |
| .0.remaining_cart.items.4.total_with_tax | Yes | Price with tax for the amount in the order. Due to rounding, this might not be exactly quantity × price_with_tax. Example: 75020. (int) |
| .0.remaining_cart.items.4.downloadable | Yes | True for services that can be fully (or sufficiently) enjoyed without a physical delivery. For instance, a course with only digital material. Example: false. (true or false) |
| .0.remaining_cart.items.4.supplier | No | Name of supplier or provider. Example: "Acme Formación". (string) |
| .0.remaining_cart.items.4.rendered | No | True when the service has been rendered Example: false. (true or false) |
| .0.delivery_method | Yes | Delivery method used on the purchase. |
| .0.delivery_method.name | Yes | Name of the delivery method. Example: "SEUR24". (string) |
| .0.delivery_method.days | No | Days it takes to deliver the goods. Example: "¡Entrega día siguiente!". (string) |
| .0.delivery_method.provider | No | Company or agent that performs the delivery. Example: "Correos". (string) |
| .0.delivery_method.home_delivery | No | If goods are delivered to the buyer's home or office and not to a pick-up place. Example: true. (true or false) |
| .0.delivery_address | No | Fields describing the delivery address. |
| .0.delivery_address.given_names | Yes | Shopper's given names for delivery. Example: "Maria José". (string) |
| .0.delivery_address.surnames | Yes | Shopper's last names for delivery. Example: "Barroso Rajoy". (string) |
| .0.delivery_address.company | Yes | Shopper company name. (string) |
| .0.delivery_address.address_line_1 | Yes | Delivery address line 1. Example: "C/ Aragó 383". (string) |
| .0.delivery_address.address_line_2 | Yes | Delivery address line 2. Example: "5º". (string) |
| .0.delivery_address.postal_code | Yes | Delivery address address postal code. Example: "08013". (string) |
| .0.delivery_address.city | Yes | Delivery address city. Example: "Barcelona". (string) |
| .0.delivery_address.country_code | Yes | Delivery address country code. Example: "ES". (string) |
| .0.delivery_address.phone | No | Shopper phone. Can be a mobile phone. Example: "933 033 033". (string) |
| .0.delivery_address.mobile_phone | No | Shopper mobile phone. Only use this field if the shopper indicated that this number is a mobile phone. Example: "615 615 615". (string) |
| .0.delivery_address.state | No | Shopper region or state. Example: "Barcelona". (string) |
| .0.delivery_address.extra | No | Extra handling information that the shopper adds to the order. Example: "I'm home between 9 and 12.". (string) |
| .0.delivery_address.vat_number | No | Shopper VAT number. Example: "B12345". (string) |
| .0.invoice_address | No | Fields describing the invoice address. |
| .0.invoice_address.given_names | Yes | Shopper's given names for invoice. Example: "Maria José". (string) |
| .0.invoice_address.surnames | Yes | Shopper's last names for invoice. Example: "Barroso Rajoy". (string) |
| .0.invoice_address.company | Yes | Shopper company name. (string) |
| .0.invoice_address.address_line_1 | Yes | Invoice address line 1. (string) |
| .0.invoice_address.address_line_2 | Yes | Invoice address line 2. (string) |
| .0.invoice_address.postal_code | Yes | Invoice address address postal code. (string) |
| .0.invoice_address.city | Yes | Invoice address city. (string) |
| .0.invoice_address.country_code | Yes | Invoice address country code. Example: "ES". (string) |
| .0.invoice_address.phone | No | Shopper phone. Can be a mobile phone. Example: "933 033 033". (string) |
| .0.invoice_address.mobile_phone | No | Shopper mobile phone. Only use this field if the shopper indicated that this number is a mobile phone. Example: "615 615 615". (string) |
| .0.invoice_address.state | No | Shopper region or state. Example: "Tarragona". (string) |
| .0.invoice_address.extra | No | Extra handling information that the shopper adds to the order. Example: "I'm home between 9 and 12.". (string) |
| .0.invoice_address.vat_number | No | Shopper VAT number. Example: "B12345". (string) |
| .0.customer | Yes | Fields describing the customer. |
| .0.customer.given_names | Yes | Customer given names. Example: "Maria José". (string) |
| .0.customer.surnames | Yes | Customer surnames. Example: "Barroso Rajoy". (string) |
| .0.customer.title | No | Customer title and/or gender. Use the one of 'mr', 'ms', 'mrs', 'miss' or 'mx' that is closest to the information supplied by the customer. If none of these can be inferred, use the title that the customer entered as-is. See also 'Note about title' in the docs. Example: "mr". (string) |
| .0.customer.email | Yes | Customer email. Example: "nisse@example.com". (string) |
| .0.customer.ref | No | Customer reference number in the shop's database. Example: 123. (string or int) |
| .0.customer.date_of_birth | No | Customer date of birth in ISO-8601 format. Example: "1980-01-20". (string) |
| .0.customer.nin | No | Customer's national identity number. For Spanish DNI, please include final letter. Example: "13003009L". (string) |
| .0.customer.company | No | Customer company name. (string) |
| .0.customer.vat_number | No | Shopper VAT number. Example: "B12345". (string) |
| .0.customer.rating | No | The merchant's rating of this customer. 0 to 100, inclusive, where 0 is "cannot be trusted" and 100 is "very trustworthy". Example: 100. (int) |
| .0.customer.nin_control | No | A validation code printed in the physical DNI or NIE. Required for multistore merchants and physical stores. See the FAQs to know more. Example: "15012018F2". (string) |
| .0.customer.vehicle | ** | Fields describing the customer's vehicle |
| .0.customer.vehicle.plaque | Yes | Plaque identificator from customer's vehicle Example: "0000AAA". (string) |
| .0.customer.vehicle.brand | No | Brand from customer's vehicle Example: "Volkswagen". (string) |
| .0.customer.vehicle.model | No | Model from customer's vehicle Example: "Beetle". (string) |
| .0.customer.vehicle.frame | No | Frame identificator from customer's vehicle Example: "VF1RFD00653635032". (string) |
| .0.customer.vehicle.first_registration_date | No | First registration date plaque from customer's vehicle Example: "2000-03-25". (string) |
| broken_orders | No | Delivered orders that cannot be properly reported. Same format as 'orders'. |
| statistics | No | Data about orders completed during the last seven days. |
| .orders | Yes | Per-order data. (list) |
| .orders.0.completed_at | Yes | When the shopper completed the order. Example: "2013-12-24T13:14:15+0100". (string) |
| .orders.0.amount | No | Total amount paid or due to pay. Example: 9957. (int) |
| .orders.0.currency | Yes | Currency of the amount. Example: "EUR". (string) |
| .orders.0.merchant_reference | No | Order id(s) used by the merchant. Please include at least for all orders where the shopper selected SeQura. |
| .orders.0.merchant_reference.order_ref_1 | Yes | Merchant reference 1. Example: "ZXCV1234". (string or int) |
| .orders.0.merchant_reference.order_ref_2 | No | Merchant reference 2. Example: "0080-1234-4343-5353". (string or int) |
| .orders.0.payment_method | No | Name or type of payment method. Use the strings CC for credit/debit cards, COD for cash on delivery, PP for PayPal, TR for bank transfer, and SQ for SeQura. For other methods, use O/ plus a name, e.g. 'O/postal_giro' Example: "CC". (string) |
| .orders.0.country | No | ISO-3166-1 country code of the delivery address. Example: "ES". (string) |
| .orders.0.device | No | Device used in purchase. Accepted values are computer, tablet, phone and other. You can follow the value with something more specific if available. Example: "tablet/ipad4". (string) |
| .orders.0.status | No | Status of the order. One of processing, shipped and cancelled. Example: "shipped". (string) |
| .orders.0.raw_status | No | Your platform's string representation of the order status. Example: "Delivered". (string) |
| .orders.0.sequra_offered | No | Was the shopper offered to use SeQura in the checkout? Example: true. (true or false) |
| platform | Yes | Fields describing the store platform. |
| .name | Yes | Name of the platform. Use your shop name. Plugins for "standard" platforms will use that name. Example: "www.theshop.es". (string) |
| .version | Yes | Version of the platform. If you don't use explicit versioning, use a release date instead. Example: "1.1". (string) |
| .plugin_version | No | Version of the plugin or platform module. If you don't use explicit versioning, use a release date instead. Example: "1.0.2". (string) |
| .uname | Yes | uname of the shop server. In PHP, use php_uname(). Example: "Darwin roatan.local 13.0.0 Darwin Kernel Version 13.0... x86_64". (string) |
| .db_name | Yes | DB used. Example: "mysql". (string) |
| .db_version | Yes | Version of the DB. Example: "1.2.3". (string) |
| .php_version | No | PHP interpreter version. Example: "5.4.1.7". (string) |
JSON examples
Some integrations use specific features that depend on the contract between the merchant and SeQura. Use the checkboxes below to see a custom example. You can ask your SeQura’s integration buddy about the contract options that affect your integration.
Contract options
- Services: The shop sells a service, i.e., it has an ending date (ends_in or ends_on fields) for the service. F.i, a course.
- Multistore: The shop has a physical store. It may have one or many different stores. This option requires these addtional fields: store_ref, operator_ref and nin_control.
- Garage: Garages have to inform the vehicle's plaque. They are also multistore. The shop requires to add garage_chain field in case it belongs to an specific chain
- Shipment_ref: If your shop makes partial shipments and it wants to track them at disbursement, use this option. Read more.
Generate the payload for your contract options
PHP example
This example includes all options and features available.
$order = array();
$order["merchant"] = array();
$order["merchant"]["id"] = "s1";
$order["orders"] = array();
$order["orders"][0] = array();
$order["orders"][0]["state"] = "shipped";
$order["orders"][0]["sent_at"] = "2014-02-05T19:21:22+01:00"; // optional
$order["orders"][0]["merchant_reference"] = array();
$order["orders"][0]["merchant_reference"]["order_ref_1"] = "ZXCV1234";
$order["orders"][0]["merchant_reference"]["order_ref_2"] = "0080-1234-4343-5353"; // optional
$order["orders"][0]["cart"] = array();
$order["orders"][0]["cart"]["currency"] = "EUR";
$order["orders"][0]["cart"]["gift"] = false;
$order["orders"][0]["cart"]["order_total_with_tax"] = 6097;
$order["orders"][0]["cart"]["cart_ref"] = "123"; // optional
$order["orders"][0]["cart"]["subscription_period"] = 24; // optional
$order["orders"][0]["cart"]["subscription_total_price"] = 1000; // optional
$order["orders"][0]["cart"]["created_at"] = "2013-10-18T12:25:20+01:00"; // optional
$order["orders"][0]["cart"]["updated_at"] = "2013-10-18T12:25:20+01:00"; // optional
$order["orders"][0]["cart"]["items"] = array();
$order["orders"][0]["cart"]["items"][0] = array();
$order["orders"][0]["cart"]["items"][0]["reference"] = "12-123-1234";
$order["orders"][0]["cart"]["items"][0]["name"] = "Leather Case (iPod nano) - Negro / Chocolate";
$order["orders"][0]["cart"]["items"][0]["price_with_tax"] = 3030;
$order["orders"][0]["cart"]["items"][0]["quantity"] = 2;
$order["orders"][0]["cart"]["items"][0]["subscription_period"] = 24; // optional
$order["orders"][0]["cart"]["items"][0]["subscription_price_per_item"] = 500; // optional
$order["orders"][0]["cart"]["items"][0]["subscription_price"] = 1000; // optional
$order["orders"][0]["cart"]["items"][0]["subscription_vat_rate"] = 2100; // optional
$order["orders"][0]["cart"]["items"][0]["total_with_tax"] = 6060;
$order["orders"][0]["cart"]["items"][0]["downloadable"] = false;
$order["orders"][0]["cart"]["items"][0]["perishable"] = false; // optional
$order["orders"][0]["cart"]["items"][0]["personalized"] = false; // optional
$order["orders"][0]["cart"]["items"][0]["restockable"] = true; // optional
$order["orders"][0]["cart"]["items"][0]["category"] = "ipod-accesorios"; // optional
$order["orders"][0]["cart"]["items"][0]["description"] = "Este estuche de cuero de última moda ..."; // optional
$order["orders"][0]["cart"]["items"][0]["manufacturer"] = "Apple"; // optional
$order["orders"][0]["cart"]["items"][0]["supplier"] = "Mayorista Makro"; // optional
$order["orders"][0]["cart"]["items"][0]["product_id"] = "6"; // optional
$order["orders"][0]["cart"]["items"][0]["url"] = "http://shop.example.com/ipod-accesorios/leather-case"; // optional
$order["orders"][0]["cart"]["items"][0]["tracking_reference"] = "first"; // optional
$order["orders"][0]["cart"]["items"][1] = array();
$order["orders"][0]["cart"]["items"][1]["type"] = "handling";
$order["orders"][0]["cart"]["items"][1]["reference"] = "seur24";
$order["orders"][0]["cart"]["items"][1]["name"] = "SEUR entrega en 24 horas";
$order["orders"][0]["cart"]["items"][1]["total_with_tax"] = 242;
$order["orders"][0]["cart"]["items"][2] = array();
$order["orders"][0]["cart"]["items"][2]["type"] = "invoice_fee";
$order["orders"][0]["cart"]["items"][2]["total_with_tax"] = 295;
$order["orders"][0]["cart"]["items"][3] = array();
$order["orders"][0]["cart"]["items"][3]["type"] = "discount";
$order["orders"][0]["cart"]["items"][3]["reference"] = "HALFOFF";
$order["orders"][0]["cart"]["items"][3]["name"] = "50 % off the full basket!";
$order["orders"][0]["cart"]["items"][3]["total_with_tax"] = -750;
$order["orders"][0]["cart"]["items"][4] = array();
$order["orders"][0]["cart"]["items"][4]["type"] = "other_payment";
$order["orders"][0]["cart"]["items"][4]["reference"] = "CASH";
$order["orders"][0]["cart"]["items"][4]["name"] = "Paid in cash";
$order["orders"][0]["cart"]["items"][4]["total_with_tax"] = -750;
$order["orders"][0]["cart"]["items"][5] = array();
$order["orders"][0]["cart"]["items"][5]["type"] = "service";
$order["orders"][0]["cart"]["items"][5]["reference"] = "NETWORKS-ADMIN-101";
$order["orders"][0]["cart"]["items"][5]["name"] = "Networks Administrator Course";
$order["orders"][0]["cart"]["items"][5]["ends_in"] = "P3M15D";
$order["orders"][0]["cart"]["items"][5]["price_with_tax"] = 3030;
$order["orders"][0]["cart"]["items"][5]["quantity"] = 1;
$order["orders"][0]["cart"]["items"][5]["total_with_tax"] = 75020;
$order["orders"][0]["cart"]["items"][5]["downloadable"] = false;
$order["orders"][0]["cart"]["items"][5]["supplier"] = "Acme Formación"; // optional
$order["orders"][0]["cart"]["items"][5]["rendered"] = false; // optional
$order["orders"][0]["cart"]["items"][9] = array();
$order["orders"][0]["cart"]["items"][9]["type"] = "subscriber_fee";
$order["orders"][0]["cart"]["items"][9]["reference"] = "12-123-1234"; // optional
$order["orders"][0]["cart"]["items"][9]["name"] = "Subscription fee";
$order["orders"][0]["cart"]["items"][9]["price_with_tax"] = 3030; // optional
$order["orders"][0]["cart"]["items"][9]["quantity"] = 2; // optional
$order["orders"][0]["cart"]["items"][9]["subscription_period"] = 24; // optional
$order["orders"][0]["cart"]["items"][9]["subscription_price_per_item"] = 500; // optional
$order["orders"][0]["cart"]["items"][9]["subscription_price"] = 1000; // optional
$order["orders"][0]["cart"]["items"][9]["subscription_vat_rate"] = 2100; // optional
$order["orders"][0]["cart"]["items"][9]["total_with_tax"] = 6060;
$order["orders"][0]["cart"]["items"][10] = array();
$order["orders"][0]["cart"]["items"][10]["type"] = "voucher";
$order["orders"][0]["cart"]["items"][10]["reference"] = "NoCashBack";
$order["orders"][0]["cart"]["items"][10]["name"] = "A voucher for your non-shipped items";
$order["orders"][0]["cart"]["items"][10]["total_with_tax"] = 1000;
$order["orders"][0]["trackings"] = array(); // optional
$order["orders"][0]["trackings"][0] = array();
$order["orders"][0]["trackings"][0]["type"] = "pickup_store";
$order["orders"][0]["trackings"][0]["reference"] = "first";
$order["orders"][0]["trackings"][0]["operator_ref"] = "123-009"; // optional
$order["orders"][0]["trackings"][0]["store_ref"] = "maquinista"; // optional
$order["orders"][0]["trackings"][0]["tracking_number"] = "AB331"; // optional
$order["orders"][0]["trackings"][0]["available_at"] = "2014-02-05T13:21:22+01:00"; // optional
$order["orders"][0]["trackings"][0]["delivered_at"] = "2014-02-05T19:21:22+01:00"; // optional
$order["orders"][0]["trackings"][0]["address_line_1"] = "1600 Pennsylvania Avenue"; // optional
$order["orders"][0]["trackings"][0]["address_line_2"] = "5º"; // optional
$order["orders"][0]["trackings"][0]["postal_code"] = "08013"; // optional
$order["orders"][0]["trackings"][0]["city"] = "Barcelona"; // optional
$order["orders"][0]["trackings"][0]["state"] = "Barcelona"; // optional
$order["orders"][0]["trackings"][0]["country_code"] = "ES"; // optional
$order["orders"][0]["trackings"][1] = array();
$order["orders"][0]["trackings"][1]["type"] = "pickup_point";
$order["orders"][0]["trackings"][1]["reference"] = "second";
$order["orders"][0]["trackings"][1]["operator_ref"] = "123-009"; // optional
$order["orders"][0]["trackings"][1]["store_ref"] = "maquinista"; // optional
$order["orders"][0]["trackings"][1]["tracking_number"] = "AB331"; // optional
$order["orders"][0]["trackings"][1]["available_at"] = "2014-02-05T13:21:22+01:00"; // optional
$order["orders"][0]["trackings"][1]["delivered_at"] = "2014-02-05T19:21:22+01:00"; // optional
$order["orders"][0]["trackings"][1]["address_line_1"] = "1600 Pennsylvania Avenue"; // optional
$order["orders"][0]["trackings"][1]["address_line_2"] = "5º"; // optional
$order["orders"][0]["trackings"][1]["postal_code"] = "08013"; // optional
$order["orders"][0]["trackings"][1]["city"] = "Barcelona"; // optional
$order["orders"][0]["trackings"][1]["state"] = "Barcelona"; // optional
$order["orders"][0]["trackings"][1]["country_code"] = "ES"; // optional
$order["orders"][0]["trackings"][2] = array();
$order["orders"][0]["trackings"][2]["type"] = "postal";
$order["orders"][0]["trackings"][2]["reference"] = "third";
$order["orders"][0]["trackings"][2]["carrier"] = "SEUR";
$order["orders"][0]["trackings"][2]["tracking_number"] = "TX123"; // optional
$order["orders"][0]["trackings"][2]["tracking_url"] = "https://logistics.es/TX123"; // optional
$order["orders"][0]["trackings"][2]["delivered_at"] = "2014-02-05T19:21:22+01:00"; // optional
$order["orders"][0]["remaining_cart"] = array(); // optional
$order["orders"][0]["remaining_cart"]["order_total_with_tax"] = 5847;
$order["orders"][0]["remaining_cart"]["items"] = array();
$order["orders"][0]["remaining_cart"]["items"][0] = array();
$order["orders"][0]["remaining_cart"]["items"][0]["reference"] = "12-123-1234";
$order["orders"][0]["remaining_cart"]["items"][0]["name"] = "Leather Case (iPod nano) - Negro / Chocolate";
$order["orders"][0]["remaining_cart"]["items"][0]["price_with_tax"] = 3030;
$order["orders"][0]["remaining_cart"]["items"][0]["quantity"] = 2;
$order["orders"][0]["remaining_cart"]["items"][0]["subscription_period"] = 24; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["subscription_price_per_item"] = 500; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["subscription_price"] = 1000; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["subscription_vat_rate"] = 2100; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["total_with_tax"] = 6060;
$order["orders"][0]["remaining_cart"]["items"][0]["downloadable"] = false;
$order["orders"][0]["remaining_cart"]["items"][0]["perishable"] = false; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["personalized"] = false; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["restockable"] = true; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["category"] = "ipod-accesorios"; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["description"] = "Este estuche de cuero de última moda ..."; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["manufacturer"] = "Apple"; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["supplier"] = "Mayorista Makro"; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["product_id"] = "6"; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["url"] = "http://shop.example.com/ipod-accesorios/leather-case"; // optional
$order["orders"][0]["remaining_cart"]["items"][0]["tracking_reference"] = "first"; // optional
$order["orders"][0]["remaining_cart"]["items"][1] = array();
$order["orders"][0]["remaining_cart"]["items"][1]["type"] = "handling";
$order["orders"][0]["remaining_cart"]["items"][1]["reference"] = "seur24";
$order["orders"][0]["remaining_cart"]["items"][1]["name"] = "SEUR entrega en 24 horas";
$order["orders"][0]["remaining_cart"]["items"][1]["total_with_tax"] = 242;
$order["orders"][0]["remaining_cart"]["items"][2] = array();
$order["orders"][0]["remaining_cart"]["items"][2]["type"] = "invoice_fee";
$order["orders"][0]["remaining_cart"]["items"][2]["total_with_tax"] = 295;
$order["orders"][0]["remaining_cart"]["items"][3] = array();
$order["orders"][0]["remaining_cart"]["items"][3]["type"] = "discount";
$order["orders"][0]["remaining_cart"]["items"][3]["reference"] = "HALFOFF";
$order["orders"][0]["remaining_cart"]["items"][3]["name"] = "50 % off the full basket!";
$order["orders"][0]["remaining_cart"]["items"][3]["total_with_tax"] = -750;
$order["orders"][0]["remaining_cart"]["items"][4] = array();
$order["orders"][0]["remaining_cart"]["items"][4]["type"] = "service";
$order["orders"][0]["remaining_cart"]["items"][4]["reference"] = "NETWORKS-ADMIN-101";
$order["orders"][0]["remaining_cart"]["items"][4]["name"] = "Networks Administrator Course";
$order["orders"][0]["remaining_cart"]["items"][4]["ends_in"] = "P3M15D";
$order["orders"][0]["remaining_cart"]["items"][4]["price_with_tax"] = 3030;
$order["orders"][0]["remaining_cart"]["items"][4]["quantity"] = 1;
$order["orders"][0]["remaining_cart"]["items"][4]["total_with_tax"] = 75020;
$order["orders"][0]["remaining_cart"]["items"][4]["downloadable"] = false;
$order["orders"][0]["remaining_cart"]["items"][4]["supplier"] = "Acme Formación"; // optional
$order["orders"][0]["remaining_cart"]["items"][4]["rendered"] = false; // optional
$order["orders"][0]["delivery_method"] = array();
$order["orders"][0]["delivery_method"]["name"] = "SEUR24";
$order["orders"][0]["delivery_method"]["days"] = "¡Entrega día siguiente!"; // optional
$order["orders"][0]["delivery_method"]["provider"] = "Correos"; // optional
$order["orders"][0]["delivery_method"]["home_delivery"] = true; // optional
$order["orders"][0]["delivery_address"] = array(); // optional
$order["orders"][0]["delivery_address"]["given_names"] = "Maria José";
$order["orders"][0]["delivery_address"]["surnames"] = "Barroso Rajoy";
$order["orders"][0]["delivery_address"]["company"] = "";
$order["orders"][0]["delivery_address"]["address_line_1"] = "C/ Aragó 383";
$order["orders"][0]["delivery_address"]["address_line_2"] = "5º";
$order["orders"][0]["delivery_address"]["postal_code"] = "08013";
$order["orders"][0]["delivery_address"]["city"] = "Barcelona";
$order["orders"][0]["delivery_address"]["country_code"] = "ES";
$order["orders"][0]["delivery_address"]["phone"] = "933 033 033"; // optional
$order["orders"][0]["delivery_address"]["mobile_phone"] = "615 615 615"; // optional
$order["orders"][0]["delivery_address"]["state"] = "Barcelona"; // optional
$order["orders"][0]["delivery_address"]["extra"] = "I'm home between 9 and 12."; // optional
$order["orders"][0]["delivery_address"]["vat_number"] = "B12345"; // optional
$order["orders"][0]["invoice_address"] = array(); // optional
$order["orders"][0]["invoice_address"]["given_names"] = "Maria José";
$order["orders"][0]["invoice_address"]["surnames"] = "Barroso Rajoy";
$order["orders"][0]["invoice_address"]["company"] = "";
$order["orders"][0]["invoice_address"]["address_line_1"] = "";
$order["orders"][0]["invoice_address"]["address_line_2"] = "";
$order["orders"][0]["invoice_address"]["postal_code"] = "";
$order["orders"][0]["invoice_address"]["city"] = "";
$order["orders"][0]["invoice_address"]["country_code"] = "ES";
$order["orders"][0]["invoice_address"]["phone"] = "933 033 033"; // optional
$order["orders"][0]["invoice_address"]["mobile_phone"] = "615 615 615"; // optional
$order["orders"][0]["invoice_address"]["state"] = "Tarragona"; // optional
$order["orders"][0]["invoice_address"]["extra"] = "I'm home between 9 and 12."; // optional
$order["orders"][0]["invoice_address"]["vat_number"] = "B12345"; // optional
$order["orders"][0]["customer"] = array();
$order["orders"][0]["customer"]["given_names"] = "Maria José";
$order["orders"][0]["customer"]["surnames"] = "Barroso Rajoy";
$order["orders"][0]["customer"]["title"] = "mr"; // optional
$order["orders"][0]["customer"]["email"] = "nisse@example.com";
$order["orders"][0]["customer"]["ref"] = 123; // optional
$order["orders"][0]["customer"]["date_of_birth"] = "1980-01-20"; // optional
$order["orders"][0]["customer"]["nin"] = "13003009L"; // optional
$order["orders"][0]["customer"]["company"] = ""; // optional
$order["orders"][0]["customer"]["vat_number"] = "B12345"; // optional
$order["orders"][0]["customer"]["rating"] = 100; // optional
$order["orders"][0]["customer"]["nin_control"] = "15012018F2"; // optional
// $order["orders"][0]["customer"]["vehicle"] = array(); // contract
$order["orders"][0]["customer"]["vehicle"]["plaque"] = "0000AAA";
$order["orders"][0]["customer"]["vehicle"]["brand"] = "Volkswagen"; // optional
$order["orders"][0]["customer"]["vehicle"]["model"] = "Beetle"; // optional
$order["orders"][0]["customer"]["vehicle"]["frame"] = "VF1RFD00653635032"; // optional
$order["orders"][0]["customer"]["vehicle"]["first_registration_date"] = "2000-03-25"; // optional
$order["broken_orders"] = array(); // optional
$order["statistics"] = array(); // optional
$order["statistics"]["orders"] = array();
$order["statistics"]["orders"][0] = array();
$order["statistics"]["orders"][0]["completed_at"] = "2013-12-24T13:14:15+0100";
$order["statistics"]["orders"][0]["amount"] = 9957; // optional
$order["statistics"]["orders"][0]["currency"] = "EUR";
$order["statistics"]["orders"][0]["merchant_reference"] = array(); // optional
$order["statistics"]["orders"][0]["merchant_reference"]["order_ref_1"] = "ZXCV1234";
$order["statistics"]["orders"][0]["merchant_reference"]["order_ref_2"] = "0080-1234-4343-5353"; // optional
$order["statistics"]["orders"][0]["payment_method"] = "CC"; // optional
$order["statistics"]["orders"][0]["country"] = "ES"; // optional
$order["statistics"]["orders"][0]["device"] = "tablet/ipad4"; // optional
$order["statistics"]["orders"][0]["status"] = "shipped"; // optional
$order["statistics"]["orders"][0]["raw_status"] = "Delivered"; // optional
$order["statistics"]["orders"][0]["sequra_offered"] = true; // optional
$order["platform"] = array();
$order["platform"]["name"] = "REPLACE WITH CORRECT VALUE BEFORE QA";
$order["platform"]["version"] = "REPLACE WITH CORRECT VALUE BEFORE QA";
$order["platform"]["plugin_version"] = "REPLACE WITH CORRECT VALUE BEFORE QA"; // optional
$order["platform"]["uname"] = "REPLACE WITH CORRECT VALUE BEFORE QA";
$order["platform"]["db_name"] = "REPLACE WITH CORRECT VALUE BEFORE QA";
$order["platform"]["db_version"] = "REPLACE WITH CORRECT VALUE BEFORE QA";
$order["platform"]["php_version"] = "REPLACE WITH CORRECT VALUE BEFORE QA"; // optional