Order found - No Header for this response

BODY

		NAME	DESCRIPTION	FORMAT
operations Array containing the operations list. Array additionalData Map of additional fields specific to the chosen payment method Object cancelledOperationId Operation id to be undone String channel It indicates the originating channel: * ECOMMERCE - cardholder initiated operation through an online channel. * POS - cardholder initiated operation through a physical POS. * BACKOFFICE - merchant initiated operation. It includes post operations and MIT. String Example: ECOMMERCE customerInfo Object containing the customer detail. Sending the content of this object increases the security level of the transaction, thus increasing the probability that two-factor authentication will not be requested in the payment. Object billingAddress Object containing the detail of the customer's address. Object additionalInfo Additional info of address, for example floor. Recommended maximum length: 50 characters. String Example: Quinto Piano, Scala B city City. Recommended maximum length: 40 characters. String Example: Bologna country State in ISO 3166-1 alpha-3 code. Recommended maximum length: 3 characters. String Example: ITA name Name and surname. Recommended maximum length: 50 characters. String Example: Mario Rossi postCode Postal code. Recommended maximum length: 16 characters. String Example: 40124 province Code of province. Recommended maximum length: 3 characters. String Example: BO street Full address. Recommended maximum length: 50 characters. String Example: Piazza Maggiore, 1 cardHolderAcctInfo Object containing information about the buyer's account. Object chAccAgeIndicator Account age indicator on the merchant site: 01 = No account 02 = Created during this transaction 03 = Created in the last 30 days 04 = Created between 30 and 60 days ago 05 = Created before 60 days ago String Example: 01 chAccChangeDate Date of the last variation of the account on the merchant's website, including Billing or Shipping address, new payment account, or new user(s) added. String Example: 2019-02-11T00:00:00.000+0000 chAccChangeIndicator Elapsed time since the last change to the buyer's account information on the merchant site, including Billing or Shipping address, new payment account, or new user(s) added. 01 = Created during this transaction 02 = Created in the last 30 days 03 = Created between 30 and 60 days ago 04 = Created before 60 days ago String Example: 01 chAccDate Date of activation of the account on the merchant's website. String Example: 2019-02-11T00:00:00.000+0000 chAccPwChangeDate Date of last account password change (including password reset). String Example: 2019-02-11T00:00:00.000+0000 chAccPwChangeIndicator Time elapsed since the buyer's account performed a password change or account recovery: 01 = No account 02 = Created during this transaction 03 = In the last 30 days 04 = Between 30 and 60 days ago 05 = Before 60 days ago String Example: 01 destinationAddressUsageDate Date of last use of this delivery address. String Example: 2019-02-11T00:00:00.000+0000 destinationAddressUsageIndicator Indicates when the shipping address used for this transaction was used for the first time: 01 = Created during this transaction 02 = Created in the last 30 days 03 = Created between 30 and 60 days ago 04 = Created before 60 days ago String Example: 01 destinationNameIndicator Indicates if the name associated with the account matches the name listed for shipping: 01 = Account name identical to the shipping address name. 02 = Different account name from the shipping address name String Example: 01 nbPurchaseAccount Number of purchases of this account in the last 6 months. Integer Example: 0 paymentAccAgeDate Payment account activation date. String Example: 2019-02-11T00:00:00.000+0000 paymentAccIndicator Indicates when the buyer has entered the Payment account on the merchant's site: 01 = No account 02 = created during this transaction 03 = Created in the last 30 days 04 = Created between 30 and 60 days ago 05 = Created before 60 days ago String Example: 0 provisionAttemptsDay Number of attempts to add a new card in the last 24 hours. Integer Example: 0 suspiciousAccActivity Indicates whether the merchant has detected suspicious activity (including previous fraud) on the buyer's account: 01 = No suspicious activity verified. 02 = Suspicious activity detected String Example: 01 txnActivityDay Number of transactions (successful and abandoned) for this account in the previous 24 hours. Integer Example: 0 txnActivityYear Number of transactions (successful and abandoned) for this account in the previous year. Integer Example: 0 cardHolderEmail Email of the cardholder. Recommended maximum length: 255 characters. String Example: mauro.morandi@nexi.it cardHolderName Name and surname of the cardholder. Recommended maximum length: 255 characters. String Example: Mauro Morandi homePhone Home phone number provided by the Cardholder. Recommended maximum length: 18 characters. String Example: 391231234567 merchantRiskIndicator Object containing information relating to the purchase made. Object deliveryEmail In case of purchase of virtual/digital products: email address to which the product is sent. String Example: john.doe@email.com deliveryTimeframe Indicator on the delivery period of the goods: 01 = Immediate Delivery (virtual/digital products). 02 = Same day delivery. 03 = Night delivery. 04 = Delivery in two or more days String Example: 01 giftCardAmount Object containing the total amount and currency of the prepaid or gift card(s) purchased. Object currency For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217. EMVCO: giftCardCurr String Example: EUR value For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in major units (for example, USD 123.45 is 123). EMVCO: giftCardAmount String Max. length: 18 Example: 100 giftCardCount Total number of individual prepaid or gift cards/codes purchased. Integer Example: 0 preOrderDate For a pre-ordered purchase, the expected date that the merchandise will be available. String Example: 2019-02-11T00:00:00.000+0000 preOrderPurchaseIndicator Indicates whether buyer is placing an order for merchandise with a future availability: 01 = Goods available. 02 = Future availability. String Example: 01 reorderItemsIndicator Indicates whether the cardholder is reordering previously purchased merchandise: 01 = First order. 02 = Goods already purchased previously. String Example: 01 shipIndicator Indicator on the type of delivery: 01 = Shipping to the billing address. 02 = Shipping to another address verified by the merchant. 03 = Delivery to a different address than the billing. 04 = Shipment or collection to the store (the address of the store must be indicated in the "destinationAddress" object). 05 = Virtual/digital goods, including online services, electronic gift certificates, recovery codes. 06 = Travel and event tickets (not sent). 07 = Other: for example games, digital services not sent, electronic media subscriptions String Example: 01 mobilePhone Mobile phone. Recommended maximum length: 15 characters. String Example: 3280987654 mobilePhoneCountryCode Prefix of the mobile phone. Recommended maximum length: 4 characters. String Example: +39 recontactConsent In certain scenarios, it is possible to collect the payer's consent to be recontacted by the merchant. This field indicates whether the payer has given such consent. Boolean shippingAddress Object containing the detail of the customer's address. Object additionalInfo Additional info of address, for example floor. Recommended maximum length: 50 characters. String Example: Quinto Piano, Scala B city City. Recommended maximum length: 40 characters. String Example: Bologna country State in ISO 3166-1 alpha-3 code. Recommended maximum length: 3 characters. String Example: ITA name Name and surname. Recommended maximum length: 50 characters. String Example: Mario Rossi postCode Postal code. Recommended maximum length: 16 characters. String Example: 40124 province Code of province. Recommended maximum length: 3 characters. String Example: BO street Full address. Recommended maximum length: 50 characters. String Example: Piazza Maggiore, 1 tin Tax Identification Number is collected in certain scenarios, such as donations, to comply with tax regulations. It is an identifier used in many countries for tax purposes. String Max. length: 32 Example: 12345678901 workPhone Work phone number provided by the Cardholder. Recommended maximum length: 18 characters. String Example: 391231234567 omnichannelId Omnichannel identifier. It is used to correlate the same operation across different channels. String operationAmount Operation amount in the payment currency String Example: 3545 operationCurrency Payment currency String Example: EUR operationId Unique identifier of the operation String Example: 852525265182852619 operationResult Outcome of the operation: * AUTHORIZED - Payment authorized * EXECUTED - Payment confirmed, verification successfully executed * DECLINED - Declined by the Issuer during the authorization phase * DENIED_BY_RISK - Negative outcome of the transaction risk analysis * THREEDS_VALIDATED - 3DS authentication OK or 3DS skipped (non-secure payment) * THREEDS_FAILED - cancellation or authentication failure during 3DS * PENDING - Payment ongoing. Follow up notifications are expected * CANCELED - Canceled by the cardholder * VOIDED - Online reversal of the full authorized amount * REFUNDED - Full or partial amount refunded * FAILED - Payment failed due to technical reasons String Example: AUTHORIZED operationTime Operation time in ISO 8601 format String operationType It indicates the purpose of the request: - AUTHORIZATION - payment authorization. - CAPTURE - capture of the authorized amount. - VOID - reversal of an authorization. - REFUND - refund of a captured amount. - CANCEL - the rollback of an capture, refund. - CARD_VERIFICATION - verify operation, without any charge, with the sole purpose of confirming the validity of the card data entered by the customer. - NOSHOW - noshow operation (reserved for Disputeless service). - INCREMENTAL - incremental operation (reserved for Disputeless service). - DELAY_CHARGE - delay charge operation (reserved for the Disputeless service). String Example: CAPTURE orderId Merchant order identifier, unique in the merchant domain. The maximum length is 27 characters. To comply with payment circuit specifications, it is strongly recommended to use an orderId of up to 18 characters. A good uniqueness strategy is to combine a stable merchant or channel prefix with a monotonic sequence, timestamp, or platform order reference, avoiding reuse for different payments. String Max. length: 27 Example: btid2384983 paymentCircuit One of the payment circuit values returned by the GET payment_methods web service. The list may include (but not limited to) VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY. String Example: VISA paymentEndToEndId Identifier defined by the circuit to uniquely identify the transaction. Required for circuit reconciliation purposes. String Min. length: 18 Max. length: 35 Example: e723hedsdew12345678 paymentInstrumentInfo Payment instrument information String Example: ***6152 paymentLinkId PayByLink id used for correlating this operation with the original link. String Example: 234244353 paymentMethod * CARD - Any card circuit * APM - Alternative payment method String Example: CARD warnings List of warnings related to the operation. Array code Warning code. String Example: TRA001 description Warning description. String Example: 3DS warning orderStatus Object containing the order detail. Object authorizedAmount Authorized amount. String capturedAmount Captured amount. String lastOperationTime Operation time. String lastOperationType It indicates the purpose of the request: - AUTHORIZATION - payment authorization. - CAPTURE - capture of the authorized amount. - VOID - reversal of an authorization. - REFUND - refund of a captured amount. - CANCEL - the rollback of an capture, refund. - CARD_VERIFICATION - verify operation, without any charge, with the sole purpose of confirming the validity of the card data entered by the customer. - NOSHOW - noshow operation (reserved for Disputeless service). - INCREMENTAL - incremental operation (reserved for Disputeless service). - DELAY_CHARGE - delay charge operation (reserved for the Disputeless service). String Example: CAPTURE order Object containing the details of the order. Object amount Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals) String Example: 3545 currency Transaction currency. ISO 4217 alphabetic code String Example: EUR customField Additional transaction description String Max. length: 255 Example: weekend promotion customerId Customer identifier computed by the merchant to match the registered customer on the ecommerce platform. Use only letters, digits, underscore (_), or hyphen (-). String Max. length: 27 Example: mcid97295873 customerInfo Object containing the customer detail. Sending the content of this object increases the security level of the transaction, thus increasing the probability that two-factor authentication will not be requested in the payment. Object billingAddress Object containing the detail of the customer's address. Object additionalInfo Additional info of address, for example floor. Recommended maximum length: 50 characters. String Example: Quinto Piano, Scala B city City. Recommended maximum length: 40 characters. String Example: Bologna country State in ISO 3166-1 alpha-3 code. Recommended maximum length: 3 characters. String Example: ITA name Name and surname. Recommended maximum length: 50 characters. String Example: Mario Rossi postCode Postal code. Recommended maximum length: 16 characters. String Example: 40124 province Code of province. Recommended maximum length: 3 characters. String Example: BO street Full address. Recommended maximum length: 50 characters. String Example: Piazza Maggiore, 1 cardHolderAcctInfo Object containing information about the buyer's account. Object chAccAgeIndicator Account age indicator on the merchant site: 01 = No account 02 = Created during this transaction 03 = Created in the last 30 days 04 = Created between 30 and 60 days ago 05 = Created before 60 days ago String Example: 01 chAccChangeDate Date of the last variation of the account on the merchant's website, including Billing or Shipping address, new payment account, or new user(s) added. String Example: 2019-02-11T00:00:00.000+0000 chAccChangeIndicator Elapsed time since the last change to the buyer's account information on the merchant site, including Billing or Shipping address, new payment account, or new user(s) added. 01 = Created during this transaction 02 = Created in the last 30 days 03 = Created between 30 and 60 days ago 04 = Created before 60 days ago String Example: 01 chAccDate Date of activation of the account on the merchant's website. String Example: 2019-02-11T00:00:00.000+0000 chAccPwChangeDate Date of last account password change (including password reset). String Example: 2019-02-11T00:00:00.000+0000 chAccPwChangeIndicator Time elapsed since the buyer's account performed a password change or account recovery: 01 = No account 02 = Created during this transaction 03 = In the last 30 days 04 = Between 30 and 60 days ago 05 = Before 60 days ago String Example: 01 destinationAddressUsageDate Date of last use of this delivery address. String Example: 2019-02-11T00:00:00.000+0000 destinationAddressUsageIndicator Indicates when the shipping address used for this transaction was used for the first time: 01 = Created during this transaction 02 = Created in the last 30 days 03 = Created between 30 and 60 days ago 04 = Created before 60 days ago String Example: 01 destinationNameIndicator Indicates if the name associated with the account matches the name listed for shipping: 01 = Account name identical to the shipping address name. 02 = Different account name from the shipping address name String Example: 01 nbPurchaseAccount Number of purchases of this account in the last 6 months. Integer Example: 0 paymentAccAgeDate Payment account activation date. String Example: 2019-02-11T00:00:00.000+0000 paymentAccIndicator Indicates when the buyer has entered the Payment account on the merchant's site: 01 = No account 02 = created during this transaction 03 = Created in the last 30 days 04 = Created between 30 and 60 days ago 05 = Created before 60 days ago String Example: 0 provisionAttemptsDay Number of attempts to add a new card in the last 24 hours. Integer Example: 0 suspiciousAccActivity Indicates whether the merchant has detected suspicious activity (including previous fraud) on the buyer's account: 01 = No suspicious activity verified. 02 = Suspicious activity detected String Example: 01 txnActivityDay Number of transactions (successful and abandoned) for this account in the previous 24 hours. Integer Example: 0 txnActivityYear Number of transactions (successful and abandoned) for this account in the previous year. Integer Example: 0 cardHolderEmail Email of the cardholder. Recommended maximum length: 255 characters. String Example: mauro.morandi@nexi.it cardHolderName Name and surname of the cardholder. Recommended maximum length: 255 characters. String Example: Mauro Morandi homePhone Home phone number provided by the Cardholder. Recommended maximum length: 18 characters. String Example: 391231234567 merchantRiskIndicator Object containing information relating to the purchase made. Object deliveryEmail In case of purchase of virtual/digital products: email address to which the product is sent. String Example: john.doe@email.com deliveryTimeframe Indicator on the delivery period of the goods: 01 = Immediate Delivery (virtual/digital products). 02 = Same day delivery. 03 = Night delivery. 04 = Delivery in two or more days String Example: 01 giftCardAmount Object containing the total amount and currency of the prepaid or gift card(s) purchased. Object currency For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217. EMVCO: giftCardCurr String Example: EUR value For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in major units (for example, USD 123.45 is 123). EMVCO: giftCardAmount String Max. length: 18 Example: 100 giftCardCount Total number of individual prepaid or gift cards/codes purchased. Integer Example: 0 preOrderDate For a pre-ordered purchase, the expected date that the merchandise will be available. String Example: 2019-02-11T00:00:00.000+0000 preOrderPurchaseIndicator Indicates whether buyer is placing an order for merchandise with a future availability: 01 = Goods available. 02 = Future availability. String Example: 01 reorderItemsIndicator Indicates whether the cardholder is reordering previously purchased merchandise: 01 = First order. 02 = Goods already purchased previously. String Example: 01 shipIndicator Indicator on the type of delivery: 01 = Shipping to the billing address. 02 = Shipping to another address verified by the merchant. 03 = Delivery to a different address than the billing. 04 = Shipment or collection to the store (the address of the store must be indicated in the "destinationAddress" object). 05 = Virtual/digital goods, including online services, electronic gift certificates, recovery codes. 06 = Travel and event tickets (not sent). 07 = Other: for example games, digital services not sent, electronic media subscriptions String Example: 01 mobilePhone Mobile phone. Recommended maximum length: 15 characters. String Example: 3280987654 mobilePhoneCountryCode Prefix of the mobile phone. Recommended maximum length: 4 characters. String Example: +39 recontactConsent In certain scenarios, it is possible to collect the payer's consent to be recontacted by the merchant. This field indicates whether the payer has given such consent. Boolean shippingAddress Object containing the detail of the customer's address. Object additionalInfo Additional info of address, for example floor. Recommended maximum length: 50 characters. String Example: Quinto Piano, Scala B city City. Recommended maximum length: 40 characters. String Example: Bologna country State in ISO 3166-1 alpha-3 code. Recommended maximum length: 3 characters. String Example: ITA name Name and surname. Recommended maximum length: 50 characters. String Example: Mario Rossi postCode Postal code. Recommended maximum length: 16 characters. String Example: 40124 province Code of province. Recommended maximum length: 3 characters. String Example: BO street Full address. Recommended maximum length: 50 characters. String Example: Piazza Maggiore, 1 tin Tax Identification Number is collected in certain scenarios, such as donations, to comply with tax regulations. It is an identifier used in many countries for tax purposes. String Max. length: 32 Example: 12345678901 workPhone Work phone number provided by the Cardholder. Recommended maximum length: 18 characters. String Example: 391231234567 description Transaction description String Max. length: 255 Example: TV LG 3423 invoiceId The Invoice ID. It must contain only supported characters: alphanumeric, underscore (_), minus (-), or plus (+) with a maximum length of 30 characters. This field is optional. [rif. ISOv93 127.98] String Max. length: 30 orderId Merchant order identifier, unique in the merchant domain. The maximum length is 27 characters. To comply with payment circuit specifications, it is strongly recommended to use an orderId of up to 18 characters. A good uniqueness strategy is to combine a stable merchant or channel prefix with a monotonic sequence, timestamp, or platform order reference, avoiding reuse for different payments. String Max. length: 27 Example: btid2384983 plan Object containing the details of the plan description. You can see the plan created through the "subscription" menu in your backoffice. Based on the different `planType` values, the plan can be used for different purposes: - FIXED: each installment has the same amount and specified due dates. - VARIABLE: each installment can have a different amount and specified due dates. - ACQUIRER_AGREEMENT: managed by the acquirer agreement, the number of installments and the amount of each installment is defined by the acquirer. Object contractId Contract identifier. The value must be between 1 and 18 characters long. To keep it unique, use a stable merchant or channel prefix together with a monotonic sequence, timestamp, or platform contract reference, avoiding reuse for different recurring contracts. String Min. length: 1 Max. length: 18 Example: C2834987 planType Possible values: - FIXED: each installment has the same amount and specified due dates. - VARIABLE: each installment can have a different amount and specified due dates. - ACQUIRER_AGREEMENT: managed by the acquirer agreement, the number of installments and the amount of each installment is defined by the acquirer. String status Possible values: - ACTIVE: the plan is active and can be used for transactions. - INACTIVE: the plan is inactive and cannot be used for transactions. - COMPLETED: the plan has been completed and all installments have been paid. String totalAmount Total amount of the plan in smallest currency unit. The currency applied is the one from the order. String products Products list in cart (also known as a shopping cart) as a virtual representation of the items a customer selects while shopping on an online store. Please note: for KLARNA payments, the product list is mandatory and the total amount of the order must match the sum of the product's prices. Array description A detailed explanation of the product that provides essential information to help customers and payment processors understand what is being purchased String Max. length: 255 Example: The Nike Air Zoom Pegasus 39 is designed for runners seeking comfort and responsiveness. Featuring a lightweight, breathable mesh upper, these shoes are built to keep your feet cool and dry throughout your run. itemCategory Different categories of items that can be processed: - PHYSICAL: A tangible item, such as a product or merchandise. - DISCOUNT: A reduction in the total price of the order. - SHIPPING_FEE: The cost associated with delivering the order. - DIGITAL: An intangible item, such as an e-book or software. - GIFT_CARD: A prepaid card that can be used for future purchases. - STORE_CREDIT: Credit issued by the store, often for returns or promotions. - SURCHARGE: An additional fee added to the order. String Example: DIGITAL name The product name that is displayed to the customer. It should be clear and concise to help the customer understand what they are purchasing String Max. length: 255 Example: Nike Air Zoom Pegasus 39 Running Shoes price The product price per unit in the smallest currency unit. - 50 EUR is represented as 5000 (2 decimals) - 50 JPY is represented as 50 (0 decimals). The product's currency matches the currency specified in the order. The price is not strictly related to the order amount. String Example: 1000 quantity The number of units the customer intends to buy Integer Example: 2 sku Stock Keeping Unit. It is a unique identifier or code assigned to each product or item sold by a retailer or e-commerce store String Max. length: 64 Example: RUN-NIK-AZP39-BLK-10 termsAndConditionsIds Facility T&C identifier array. Insertion of terms and conditions Array transactionSummary Transaction summary list, containing the details of the transaction. Array language Language in ISO 639-2 three-letter code. String Min. length: 3 Max. length: 3 Default: ITA Example: ENG summaryList Array containing the summary list. Array label Label of the fields. String Max. length: 50 Example: Number of people value Value. String Max. length: 50 Example: 4 paymentLink Array containing the payment links list. Array amount Transaction amount in smallest currency unit. 5000 corresponds to 50,00 €. Expressed in the currency of the payment. String expirationDate Expiration date of the Pay-By-Link link. String link Payment URL for Pay-By-Link. String linkId Identifier of the Pay-By-Link link. String paidByOperationId Operation identifier associated with payment through Pay-By-Link link. String status Status of the Pay-By-Link link, possible values: - ACTIVE - DELETED - EXPIRED - INACTIVE String