Next you can find the complete list of fields you may use in the payload. If you prefer, you can directly Go to the JSON 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.merchant_reference.subscription_ref_1 No Subscription reference 1. Example: "SUBS00001". (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. (positive 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. (positive 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.merchant_reference.subscription_ref_1 No Subscription reference 1. Example: "SUBS00001". (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]["merchant_reference"]["subscription_ref_1"] = "SUBS00001"; // 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]["merchant_reference"]["subscription_ref_1"] = "SUBS00001"; // 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