Skip to content
XPayGreece

    XPay Payment APIs

    Scroll down for code samples, example requests and responses.
    Select a language for code samples from the tabs or the mobile navigation menu.

    Create Order for Hosted Payment

    POST /orders/hpp

    Hosted Payment Initialization. Server-to-Server API for starting the order lifecycle

    Parameters

    • X-API-KEYstringrequired
    • Correlation-Idstring (uuid)required

    Create Order for Hosted Payment

    var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/hpp");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

    Request body

    • orderobjectoptional
      • orderIdstringrequired

        Merchant order id, unique in the merchant domain

        example: btid2384983
      • amountstringrequired

        Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

        example: 3545
      • currencystringrequired

        Transaction currency. ISO 4217 alphabetic code

        example: EUR
      • customerIdstringoptional

        Customer label for this transaction

        example: mcid97295873
      • descriptionstringoptional

        Transaction description

        example: TV LG 3423
      • customFieldstringoptional

        Additional transaction description

        example: weekend promotion
      • customerInfoobjectoptional
        • cardHolderNamestringrequiredexample: Mauro Morandi
        • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
        • billingAddressobjectoptional
          • namestringoptionalexample: Mario Rossi
          • streetstringoptionalexample: Piazza Maggiore, 1
          • additionalInfostringoptionalexample: Quinto Piano, Scala B
          • citystringoptionalexample: Bologna
          • postCodestringoptionalexample: 40124
          • provincestringoptionalexample: BO
          • countrystringoptional

            ISO 3166-1 alpha-3

            example: ITA
        • shippingAddressobjectoptional
          • namestringoptionalexample: Mario Rossi
          • streetstringoptionalexample: Piazza Maggiore, 1
          • additionalInfostringoptionalexample: Quinto Piano, Scala B
          • citystringoptionalexample: Bologna
          • postCodestringoptionalexample: 40124
          • provincestringoptionalexample: BO
          • countrystringoptional

            ISO 3166-1 alpha-3

            example: ITA
        • mobilePhoneCountryCodestringoptionalexample: 39
        • mobilePhonestringoptionalexample: 3280987654
        • homePhonestringoptional

          The home phone number provided by the Cardholder.

          example: 391231234567
        • workPhonestringoptional

          The work phone number provided by the Cardholder.

          example: 391231234567
        • cardHolderAcctInfoobjectoptional
          • chAccDatestringoptional

            Date that the cardholder opened the account with the 3DS Requestor.

            example: 2019-02-11T00:00:00.000Z
          • chAccAgeIndicatorstringoptional

            Length of time that the cardholder has had the account with the 3DS Requestor.

            example: 01
          • chAccChangeDatestringoptional

            Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

            example: 2019-02-11T00:00:00.000Z
          • chAccChangeIndicatorstringoptional

            Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

            example: 01
          • chAccPwChangeDatestringoptional

            Date that cardholder's account with the 3DS Requestor had a password change or account reset.

            example: 2019-02-11T00:00:00.000Z
          • chAccPwChangeIndicatorstringoptional

            Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

            example: 01
          • nbPurchaseAccountnumberoptional

            Number of purchases with this cardholder account during the previous six months.

            example: 0
          • destinationAddressUsageDatestringoptional

            Date when the shipping address used for this transaction was first used with the 3DS Requestor.

            example: 2019-02-11T00:00:00.000Z
          • destinationAddressUsageIndicatorstringoptional

            Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

            example: 01
          • destinationNameIndicatorstringoptional

            Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

            example: 01
          • txnActivityDaynumberoptional

            Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

            example: 0
          • txnActivityYearnumberoptional

            Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

            example: 0
          • provisionAttemptsDaynumberoptional

            Number of Add Card attempts in the last 24 hours.

            example: 0
          • suspiciousAccActivitystringoptional

            Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

            example: 01
          • paymentAccAgeDatestringoptional

            Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

            example: 2019-02-11T00:00:00.000Z
          • paymentAccIndicatorstringoptional

            Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

            example: 0
        • merchantRiskIndicatorobjectoptional
          • deliveryEmailstringoptional

            For Electronic delivery, the email address to which the merchandise was delivered.

            example: john.doe@email.com
          • deliveryTimeframestringoptional

            Indicates the merchandise delivery timeframe.

            example: 01
          • giftCardAmountobjectoptional
            • valuenumberoptional

              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).

              example: 100
            • currencystringoptional

              For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

              example: EUR
          • giftCardCountnumberoptional

            For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

            example: 0
          • preOrderDatestringoptional

            For a pre-ordered purchase, the expected date that the merchandise will be available.

            example: 2019-02-11T00:00:00.000Z
          • preOrderPurchaseIndicatorstringoptional

            Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

            example: 01
          • reorderItemsIndicatorstringoptional

            Indicates whether the cardholder is reordering previously purchased merchandise.

            example: 01
          • shipIndicatorstringoptional

            Indicates shipping method chosen for the transaction.

            example: 01
      • transactionSummaryarrayoptional
        • languagestringoptional

          Language to be used on the transaction summary details, ISO 639-2.

          example: eng
        • summaryListarrayoptional
          • labelstringoptional

            label of the field

            example: Number of people
          • valuestringoptional

            value

            example: 4
      • installmentsarrayoptional
        • datestringoptional

          Installment time.

          example: 2022-09-01T00:00:00.000Z
        • amountstringoptional

          Installment amount.

          example: 350
      • termsAndConditionsIdsarrayoptional
    • paymentSessionobjectoptional
      • actionTypestringoptional

        PAY, VERIFY, PREAUTH

        example: PAY
      • amountstringrequired

        Amount of the first payment which may be less or equals to the order amount. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

        example: 3545
      • recurrenceobjectoptional
        • actionstringoptional

          NO_RECURRING, SUBSEQUENT_PAYMENT, CONTRACT_CREATION, CARD_SUBSTITUTION

          example: NO_RECURRING
        • contractIdstringoptionalexample: C2834987
        • contractTypestringoptional

          MIT_UNSCHEDULED, MIT_SCHEDULED, CIT

          example: MIT_UNSCHEDULED
        • contractExpiryDatestringoptional

          Used with contractType MIT_SCHEDULED.

          example: 2023-03-16T00:00:00.000Z
        • contractFrequencystringoptional

          Used with contractType MIT_SCHEDULED. Number of days

          example: 120
      • captureTypestringoptional

        Overwrites the default confirmation method of the terminal, for card payments only:

        • IMPLICIT - automatic confirmation
        • EXPLICIT - authorization only
          Default value depends on the terminal configuration.

        IMPLICIT, EXPLICIT

        example: EXPLICIT
      • exemptionsstringoptional

        NO_PREFERENCE, CHALLENGE_REQUESTED

        example: NO_PREFERENCE
      • languagestringrequired

        Language to be used on the hosted payment page. ISO 639-2

        example: ita
      • resultUrlstringoptional

        Merchant URL where the cardholder is redirected once the hosted payment completes

        example: https://{merchant_result_url}
      • cancelUrlstringoptional

        Merchant URL where the cardholder is redirected once the hosted payment is abandoned

        example: https://{merchant_cancel_url}
      • notificationUrlstringoptional

        Merchant URL where the gateway pushes notifications

        example: https://{merchant_notification_url}

    Request body

    {
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "paymentSession": {
        "actionType": "PAY",
        "amount": "3545",
        "recurrence": {
            "action": "NO_RECURRING",
            "contractId": "C2834987",
            "contractType": "MIT_UNSCHEDULED",
            "contractExpiryDate": "2023-03-16T00:00:00.000Z",
            "contractFrequency": "120"
        },
        "captureType": "EXPLICIT",
        "exemptions": "NO_PREFERENCE",
        "language": "ita",
        "resultUrl": "https://{merchant_result_url}",
        "cancelUrl": "https://{merchant_cancel_url}",
        "notificationUrl": "https://{merchant_notification_url}"
    }
}

    Responses

    • 200Payment initialization successfuloptional
      • hostedPagestringoptional

        URL of the hosted payment page. Redirect the payment flow to this URL.

        example: https://{gateway_hosted_page}
      • securityTokenstringoptional

        Token which may be used for validating the notifications related to this payment

        example: 2f0ea5059b41414ca3744fe672327d85
    • 400Invalid request dataoptional
      • errorsarrayoptional
        • codestringoptionalexample: GW0001
        • descriptionstringoptionalexample: Invalid merchant URL
    • 401Unauthorizedoptional
    • 500Internal Server Erroroptional
      • errorsarrayoptional
        • codestringoptionalexample: GW0001
        • descriptionstringoptionalexample: Invalid merchant URL
    {
    "hostedPage": "https://{gateway_hosted_page}",
    "securityToken": "2f0ea5059b41414ca3744fe672327d85"
}

    Find Orders

    GET /orders

    Find orders in reversed chronological order

    Parameters

    • X-API-KEYstringrequired
    • Correlation-Idstring (uuid)required
    • fromTimestringoptional
    • toTimestringoptional
    • maxRecordsnumberoptional
    • customFieldstringoptional

    Find Orders

    var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders?fromTime=SOME_STRING_VALUE&toTime=SOME_STRING_VALUE&maxRecords=SOME_NUMBER_VALUE&customField=SOME_STRING_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

    Responses

    • 200Request successfully processedoptional
      • ordersarrayoptional
        • orderobjectoptional
          • orderIdstringrequired

            Merchant order id, unique in the merchant domain

            example: btid2384983
          • amountstringrequired

            Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

            example: 3545
          • currencystringrequired

            Transaction currency. ISO 4217 alphabetic code

            example: EUR
          • customerIdstringoptional

            Customer label for this transaction

            example: mcid97295873
          • descriptionstringoptional

            Transaction description

            example: TV LG 3423
          • customFieldstringoptional

            Additional transaction description

            example: weekend promotion
          • customerInfoobjectoptional
            • cardHolderNamestringrequiredexample: Mauro Morandi
            • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
            • billingAddressobjectoptional
              • namestringoptionalexample: Mario Rossi
              • streetstringoptionalexample: Piazza Maggiore, 1
              • additionalInfostringoptionalexample: Quinto Piano, Scala B
              • citystringoptionalexample: Bologna
              • postCodestringoptionalexample: 40124
              • provincestringoptionalexample: BO
              • countrystringoptional

                ISO 3166-1 alpha-3

                example: ITA
            • shippingAddressobjectoptional
              • namestringoptionalexample: Mario Rossi
              • streetstringoptionalexample: Piazza Maggiore, 1
              • additionalInfostringoptionalexample: Quinto Piano, Scala B
              • citystringoptionalexample: Bologna
              • postCodestringoptionalexample: 40124
              • provincestringoptionalexample: BO
              • countrystringoptional

                ISO 3166-1 alpha-3

                example: ITA
            • mobilePhoneCountryCodestringoptionalexample: 39
            • mobilePhonestringoptionalexample: 3280987654
            • homePhonestringoptional

              The home phone number provided by the Cardholder.

              example: 391231234567
            • workPhonestringoptional

              The work phone number provided by the Cardholder.

              example: 391231234567
            • cardHolderAcctInfoobjectoptional
              • chAccDatestringoptional

                Date that the cardholder opened the account with the 3DS Requestor.

                example: 2019-02-11T00:00:00.000Z
              • chAccAgeIndicatorstringoptional

                Length of time that the cardholder has had the account with the 3DS Requestor.

                example: 01
              • chAccChangeDatestringoptional

                Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                example: 2019-02-11T00:00:00.000Z
              • chAccChangeIndicatorstringoptional

                Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                example: 01
              • chAccPwChangeDatestringoptional

                Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                example: 2019-02-11T00:00:00.000Z
              • chAccPwChangeIndicatorstringoptional

                Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                example: 01
              • nbPurchaseAccountnumberoptional

                Number of purchases with this cardholder account during the previous six months.

                example: 0
              • destinationAddressUsageDatestringoptional

                Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                example: 2019-02-11T00:00:00.000Z
              • destinationAddressUsageIndicatorstringoptional

                Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                example: 01
              • destinationNameIndicatorstringoptional

                Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                example: 01
              • txnActivityDaynumberoptional

                Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                example: 0
              • txnActivityYearnumberoptional

                Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                example: 0
              • provisionAttemptsDaynumberoptional

                Number of Add Card attempts in the last 24 hours.

                example: 0
              • suspiciousAccActivitystringoptional

                Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                example: 01
              • paymentAccAgeDatestringoptional

                Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                example: 2019-02-11T00:00:00.000Z
              • paymentAccIndicatorstringoptional

                Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                example: 0
            • merchantRiskIndicatorobjectoptional
              • deliveryEmailstringoptional

                For Electronic delivery, the email address to which the merchandise was delivered.

                example: john.doe@email.com
              • deliveryTimeframestringoptional

                Indicates the merchandise delivery timeframe.

                example: 01
              • giftCardAmountobjectoptional
                • valuenumberoptional

                  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).

                  example: 100
                • currencystringoptional

                  For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                  example: EUR
              • giftCardCountnumberoptional

                For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                example: 0
              • preOrderDatestringoptional

                For a pre-ordered purchase, the expected date that the merchandise will be available.

                example: 2019-02-11T00:00:00.000Z
              • preOrderPurchaseIndicatorstringoptional

                Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                example: 01
              • reorderItemsIndicatorstringoptional

                Indicates whether the cardholder is reordering previously purchased merchandise.

                example: 01
              • shipIndicatorstringoptional

                Indicates shipping method chosen for the transaction.

                example: 01
          • transactionSummaryarrayoptional
            • languagestringoptional

              Language to be used on the transaction summary details, ISO 639-2.

              example: eng
            • summaryListarrayoptional
              • labelstringoptional

                label of the field

                example: Number of people
              • valuestringoptional

                value

                example: 4
          • installmentsarrayoptional
            • datestringoptional

              Installment time.

              example: 2022-09-01T00:00:00.000Z
            • amountstringoptional

              Installment amount.

              example: 350
          • termsAndConditionsIdsarrayoptional
        • authorizedAmountstringoptionalexample: 3545
        • capturedAmountstringoptionalexample: 3545
        • lastOperationTypestringoptional

          It indicates the purpose of the request:

          • AUTHORIZATION - any authorization with explicit capture
          • CAPTURE - a captured authorization or an implicit captured payment
          • VOID - reversal of an authorization
          • REFUND - refund of a captured amount
          • CANCEL - the rollback of an capture, refund.

          AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

          example: CAPTURE
        • lastOperationTimestringoptional

          Operation time

          example: 2022-11-25T15:38:28.135Z
    • 401Unauthorizedoptional
    • 500Internal Server Erroroptional
      • errorsarrayoptional
        • codestringoptionalexample: GW0001
        • descriptionstringoptionalexample: Invalid merchant URL
    {
    "orders": [
        {
            "order": {
                "orderId": "btid2384983",
                "amount": "3545",
                "currency": "EUR",
                "customerId": "mcid97295873",
                "description": "TV LG 3423",
                "customField": "weekend promotion",
                "customerInfo": {
                    "cardHolderName": "Mauro Morandi",
                    "cardHolderEmail": "mauro.morandi@nexi.it",
                    "billingAddress": {
                        "name": "Mario Rossi",
                        "street": "Piazza Maggiore, 1",
                        "additionalInfo": "Quinto Piano, Scala B",
                        "city": "Bologna",
                        "postCode": "40124",
                        "province": "BO",
                        "country": "ITA"
                    },
                    "shippingAddress": {
                        "name": "Mario Rossi",
                        "street": "Piazza Maggiore, 1",
                        "additionalInfo": "Quinto Piano, Scala B",
                        "city": "Bologna",
                        "postCode": "40124",
                        "province": "BO",
                        "country": "ITA"
                    },
                    "mobilePhoneCountryCode": "39",
                    "mobilePhone": "3280987654",
                    "homePhone": 391231234567,
                    "workPhone": 391231234567,
                    "cardHolderAcctInfo": {
                        "chAccDate": "2019-02-11T00:00:00.000Z",
                        "chAccAgeIndicator": "01",
                        "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                        "chAccChangeIndicator": "01",
                        "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                        "chAccPwChangeIndicator": "01",
                        "nbPurchaseAccount": 0,
                        "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                        "destinationAddressUsageIndicator": "01",
                        "destinationNameIndicator": "01",
                        "txnActivityDay": 0,
                        "txnActivityYear": 0,
                        "provisionAttemptsDay": 0,
                        "suspiciousAccActivity": "01",
                        "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                        "paymentAccIndicator": "0"
                    },
                    "merchantRiskIndicator": {
                        "deliveryEmail": "john.doe@email.com",
                        "deliveryTimeframe": "01",
                        "giftCardAmount": {
                            "value": 100,
                            "currency": "EUR"
                        },
                        "giftCardCount": 0,
                        "preOrderDate": "2019-02-11T00:00:00.000Z",
                        "preOrderPurchaseIndicator": "01",
                        "reorderItemsIndicator": "01",
                        "shipIndicator": "01"
                    }
                },
                "transactionSummary": [
                    {
                        "language": "eng",
                        "summaryList": [
                            {
                                "label": "Number of people",
                                "value": "4"
                            }
                        ]
                    }
                ],
                "installments": [
                    {
                        "date": "2022-09-01T00:00:00.000Z",
                        "amount": "350"
                    }
                ],
                "termsAndConditionsIds": [
                    "16dd6ac6-0791-4c72-b362-85f77f1728a2"
                ]
            },
            "authorizedAmount": "3545",
            "capturedAmount": "3545",
            "lastOperationType": "CAPTURE",
            "lastOperationTime": "2022-11-25T15:38:28.135Z"
        }
    ]
}

    Find Order by ID

    GET /orders/{orderId}

    Retrieve all the operations for the given order

    Parameters

    • X-API-KEYstringrequired
    • Correlation-Idstring (uuid)required
    • orderIdstringrequired

      Merchant order id

    Find Order by ID

    var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/btid2384983");
var request = new RestRequest(Method.GET);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

    Responses

    • 200Order foundoptional
      • orderStatusobjectoptional
        • orderobjectoptional
          • orderIdstringrequired

            Merchant order id, unique in the merchant domain

            example: btid2384983
          • amountstringrequired

            Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

            example: 3545
          • currencystringrequired

            Transaction currency. ISO 4217 alphabetic code

            example: EUR
          • customerIdstringoptional

            Customer label for this transaction

            example: mcid97295873
          • descriptionstringoptional

            Transaction description

            example: TV LG 3423
          • customFieldstringoptional

            Additional transaction description

            example: weekend promotion
          • customerInfoobjectoptional
            • cardHolderNamestringrequiredexample: Mauro Morandi
            • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
            • billingAddressobjectoptional
              • namestringoptionalexample: Mario Rossi
              • streetstringoptionalexample: Piazza Maggiore, 1
              • additionalInfostringoptionalexample: Quinto Piano, Scala B
              • citystringoptionalexample: Bologna
              • postCodestringoptionalexample: 40124
              • provincestringoptionalexample: BO
              • countrystringoptional

                ISO 3166-1 alpha-3

                example: ITA
            • shippingAddressobjectoptional
              • namestringoptionalexample: Mario Rossi
              • streetstringoptionalexample: Piazza Maggiore, 1
              • additionalInfostringoptionalexample: Quinto Piano, Scala B
              • citystringoptionalexample: Bologna
              • postCodestringoptionalexample: 40124
              • provincestringoptionalexample: BO
              • countrystringoptional

                ISO 3166-1 alpha-3

                example: ITA
            • mobilePhoneCountryCodestringoptionalexample: 39
            • mobilePhonestringoptionalexample: 3280987654
            • homePhonestringoptional

              The home phone number provided by the Cardholder.

              example: 391231234567
            • workPhonestringoptional

              The work phone number provided by the Cardholder.

              example: 391231234567
            • cardHolderAcctInfoobjectoptional
              • chAccDatestringoptional

                Date that the cardholder opened the account with the 3DS Requestor.

                example: 2019-02-11T00:00:00.000Z
              • chAccAgeIndicatorstringoptional

                Length of time that the cardholder has had the account with the 3DS Requestor.

                example: 01
              • chAccChangeDatestringoptional

                Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                example: 2019-02-11T00:00:00.000Z
              • chAccChangeIndicatorstringoptional

                Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                example: 01
              • chAccPwChangeDatestringoptional

                Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                example: 2019-02-11T00:00:00.000Z
              • chAccPwChangeIndicatorstringoptional

                Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                example: 01
              • nbPurchaseAccountnumberoptional

                Number of purchases with this cardholder account during the previous six months.

                example: 0
              • destinationAddressUsageDatestringoptional

                Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                example: 2019-02-11T00:00:00.000Z
              • destinationAddressUsageIndicatorstringoptional

                Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                example: 01
              • destinationNameIndicatorstringoptional

                Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                example: 01
              • txnActivityDaynumberoptional

                Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                example: 0
              • txnActivityYearnumberoptional

                Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                example: 0
              • provisionAttemptsDaynumberoptional

                Number of Add Card attempts in the last 24 hours.

                example: 0
              • suspiciousAccActivitystringoptional

                Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                example: 01
              • paymentAccAgeDatestringoptional

                Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                example: 2019-02-11T00:00:00.000Z
              • paymentAccIndicatorstringoptional

                Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                example: 0
            • merchantRiskIndicatorobjectoptional
              • deliveryEmailstringoptional

                For Electronic delivery, the email address to which the merchandise was delivered.

                example: john.doe@email.com
              • deliveryTimeframestringoptional

                Indicates the merchandise delivery timeframe.

                example: 01
              • giftCardAmountobjectoptional
                • valuenumberoptional

                  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).

                  example: 100
                • currencystringoptional

                  For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                  example: EUR
              • giftCardCountnumberoptional

                For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                example: 0
              • preOrderDatestringoptional

                For a pre-ordered purchase, the expected date that the merchandise will be available.

                example: 2019-02-11T00:00:00.000Z
              • preOrderPurchaseIndicatorstringoptional

                Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                example: 01
              • reorderItemsIndicatorstringoptional

                Indicates whether the cardholder is reordering previously purchased merchandise.

                example: 01
              • shipIndicatorstringoptional

                Indicates shipping method chosen for the transaction.

                example: 01
          • transactionSummaryarrayoptional
            • languagestringoptional

              Language to be used on the transaction summary details, ISO 639-2.

              example: eng
            • summaryListarrayoptional
              • labelstringoptional

                label of the field

                example: Number of people
              • valuestringoptional

                value

                example: 4
          • installmentsarrayoptional
            • datestringoptional

              Installment time.

              example: 2022-09-01T00:00:00.000Z
            • amountstringoptional

              Installment amount.

              example: 350
          • termsAndConditionsIdsarrayoptional
        • authorizedAmountstringoptionalexample: 3545
        • capturedAmountstringoptionalexample: 3545
        • lastOperationTypestringoptional

          It indicates the purpose of the request:

          • AUTHORIZATION - any authorization with explicit capture
          • CAPTURE - a captured authorization or an implicit captured payment
          • VOID - reversal of an authorization
          • REFUND - refund of a captured amount
          • CANCEL - the rollback of an capture, refund.

          AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

          example: CAPTURE
        • lastOperationTimestringoptional

          Operation time

          example: 2022-11-25T15:38:28.135Z
      • operationsarrayoptional
        • orderIdstringoptional

          Merchant order id, unique in the merchant domain

          example: btid2384983
        • operationIdstringoptionalexample: 3470744
        • channelstringoptional

          It indicates the originating channel:

          • ECOMMERCE - carholder initiated operation through an online channel.
          • POS - carholder initiated operation through a physical POS.
          • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

          ECOMMERCE, POS, BACKOFFICE

          example: ECOMMERCE
        • operationTypestringoptional

          It indicates the purpose of the request:

          • AUTHORIZATION - any authorization with explicit capture
          • CAPTURE - a captured authorization or an implicit captured payment
          • VOID - reversal of an authorization
          • REFUND - refund of a captured amount
          • CANCEL - the rollback of an capture, refund.

          AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

          example: CAPTURE
        • operationResultstringoptional

          Transaction output:

          • 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

          AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

          example: AUTHORIZED
        • operationTimestringoptional

          Operation time

          example: 2022-11-25T15:38:28.135Z
        • paymentMethodstringoptional
          • CARD - Any card circuit
          • APM - Alternative payment method

          CARD, APM

          example: CARD
        • paymentCircuitstringoptional

          one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

          example: VISA
        • paymentInstrumentInfostringoptional

          Payment instrument information

          example: ***6152
        • paymentEndToEndIdstringoptional

          It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

          example: e723hedsdew
        • cancelledOperationIdstringoptional

          Operation id to be undone

        • operationAmountstringoptional

          Operation amount in the payment currency

          example: 3545
        • operationCurrencystringoptional

          Payment currency

          example: EUR
        • customerInfoobjectoptional
          • cardHolderNamestringrequiredexample: Mauro Morandi
          • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
          • billingAddressobjectoptional
            • namestringoptionalexample: Mario Rossi
            • streetstringoptionalexample: Piazza Maggiore, 1
            • additionalInfostringoptionalexample: Quinto Piano, Scala B
            • citystringoptionalexample: Bologna
            • postCodestringoptionalexample: 40124
            • provincestringoptionalexample: BO
            • countrystringoptional

              ISO 3166-1 alpha-3

              example: ITA
          • shippingAddressobjectoptional
            • namestringoptionalexample: Mario Rossi
            • streetstringoptionalexample: Piazza Maggiore, 1
            • additionalInfostringoptionalexample: Quinto Piano, Scala B
            • citystringoptionalexample: Bologna
            • postCodestringoptionalexample: 40124
            • provincestringoptionalexample: BO
            • countrystringoptional

              ISO 3166-1 alpha-3

              example: ITA
          • mobilePhoneCountryCodestringoptionalexample: 39
          • mobilePhonestringoptionalexample: 3280987654
          • homePhonestringoptional

            The home phone number provided by the Cardholder.

            example: 391231234567
          • workPhonestringoptional

            The work phone number provided by the Cardholder.

            example: 391231234567
          • cardHolderAcctInfoobjectoptional
            • chAccDatestringoptional

              Date that the cardholder opened the account with the 3DS Requestor.

              example: 2019-02-11T00:00:00.000Z
            • chAccAgeIndicatorstringoptional

              Length of time that the cardholder has had the account with the 3DS Requestor.

              example: 01
            • chAccChangeDatestringoptional

              Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

              example: 2019-02-11T00:00:00.000Z
            • chAccChangeIndicatorstringoptional

              Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

              example: 01
            • chAccPwChangeDatestringoptional

              Date that cardholder's account with the 3DS Requestor had a password change or account reset.

              example: 2019-02-11T00:00:00.000Z
            • chAccPwChangeIndicatorstringoptional

              Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

              example: 01
            • nbPurchaseAccountnumberoptional

              Number of purchases with this cardholder account during the previous six months.

              example: 0
            • destinationAddressUsageDatestringoptional

              Date when the shipping address used for this transaction was first used with the 3DS Requestor.

              example: 2019-02-11T00:00:00.000Z
            • destinationAddressUsageIndicatorstringoptional

              Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

              example: 01
            • destinationNameIndicatorstringoptional

              Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

              example: 01
            • txnActivityDaynumberoptional

              Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

              example: 0
            • txnActivityYearnumberoptional

              Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

              example: 0
            • provisionAttemptsDaynumberoptional

              Number of Add Card attempts in the last 24 hours.

              example: 0
            • suspiciousAccActivitystringoptional

              Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

              example: 01
            • paymentAccAgeDatestringoptional

              Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

              example: 2019-02-11T00:00:00.000Z
            • paymentAccIndicatorstringoptional

              Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

              example: 0
          • merchantRiskIndicatorobjectoptional
            • deliveryEmailstringoptional

              For Electronic delivery, the email address to which the merchandise was delivered.

              example: john.doe@email.com
            • deliveryTimeframestringoptional

              Indicates the merchandise delivery timeframe.

              example: 01
            • giftCardAmountobjectoptional
              • valuenumberoptional

                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).

                example: 100
              • currencystringoptional

                For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                example: EUR
            • giftCardCountnumberoptional

              For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

              example: 0
            • preOrderDatestringoptional

              For a pre-ordered purchase, the expected date that the merchandise will be available.

              example: 2019-02-11T00:00:00.000Z
            • preOrderPurchaseIndicatorstringoptional

              Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

              example: 01
            • reorderItemsIndicatorstringoptional

              Indicates whether the cardholder is reordering previously purchased merchandise.

              example: 01
            • shipIndicatorstringoptional

              Indicates shipping method chosen for the transaction.

              example: 01
        • warningsarrayoptional
          • codestringoptionalexample: TRA001
          • descriptionstringoptionalexample: 3DS warning
        • paymentLinkIdstringoptional

          PayByLink id used for correlating this operation with the original link.

          example: 234244353
        • additionalDataobjectoptional

          Map of additional fields specific to the chosen payment method

      • paymentLinksarrayoptional
        • linkIdstringoptional

          Unique identifier for this link.

          example: 92864835
        • amountstringoptional

          Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

          example: 3545
        • expirationDatestringoptional

          Expiration date.

          example: 2022-09-01T00:00:00.000Z
        • linkstringoptional

          Link to be shared with the customer for doing the payment.

          example: https://{gateway_hosted_page}
        • paidByOperationIdstringoptional

          Operation Id identifying the successful payment related to this link.

          example: 3470744
    • 401Unauthorizedoptional
    • 404Order not foundoptional
    • 500Internal Server Erroroptional
      • errorsarrayoptional
        • codestringoptionalexample: GW0001
        • descriptionstringoptionalexample: Invalid merchant URL
    {
    "orderStatus": {
        "order": {
            "orderId": "btid2384983",
            "amount": "3545",
            "currency": "EUR",
            "customerId": "mcid97295873",
            "description": "TV LG 3423",
            "customField": "weekend promotion",
            "customerInfo": {
                "cardHolderName": "Mauro Morandi",
                "cardHolderEmail": "mauro.morandi@nexi.it",
                "billingAddress": {
                    "name": "Mario Rossi",
                    "street": "Piazza Maggiore, 1",
                    "additionalInfo": "Quinto Piano, Scala B",
                    "city": "Bologna",
                    "postCode": "40124",
                    "province": "BO",
                    "country": "ITA"
                },
                "shippingAddress": {
                    "name": "Mario Rossi",
                    "street": "Piazza Maggiore, 1",
                    "additionalInfo": "Quinto Piano, Scala B",
                    "city": "Bologna",
                    "postCode": "40124",
                    "province": "BO",
                    "country": "ITA"
                },
                "mobilePhoneCountryCode": "39",
                "mobilePhone": "3280987654",
                "homePhone": 391231234567,
                "workPhone": 391231234567,
                "cardHolderAcctInfo": {
                    "chAccDate": "2019-02-11T00:00:00.000Z",
                    "chAccAgeIndicator": "01",
                    "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                    "chAccChangeIndicator": "01",
                    "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                    "chAccPwChangeIndicator": "01",
                    "nbPurchaseAccount": 0,
                    "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                    "destinationAddressUsageIndicator": "01",
                    "destinationNameIndicator": "01",
                    "txnActivityDay": 0,
                    "txnActivityYear": 0,
                    "provisionAttemptsDay": 0,
                    "suspiciousAccActivity": "01",
                    "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                    "paymentAccIndicator": "0"
                },
                "merchantRiskIndicator": {
                    "deliveryEmail": "john.doe@email.com",
                    "deliveryTimeframe": "01",
                    "giftCardAmount": {
                        "value": 100,
                        "currency": "EUR"
                    },
                    "giftCardCount": 0,
                    "preOrderDate": "2019-02-11T00:00:00.000Z",
                    "preOrderPurchaseIndicator": "01",
                    "reorderItemsIndicator": "01",
                    "shipIndicator": "01"
                }
            },
            "transactionSummary": [
                {
                    "language": "eng",
                    "summaryList": [
                        {
                            "label": "Number of people",
                            "value": "4"
                        }
                    ]
                }
            ],
            "installments": [
                {
                    "date": "2022-09-01T00:00:00.000Z",
                    "amount": "350"
                }
            ],
            "termsAndConditionsIds": [
                "16dd6ac6-0791-4c72-b362-85f77f1728a2"
            ]
        },
        "authorizedAmount": "3545",
        "capturedAmount": "3545",
        "lastOperationType": "CAPTURE",
        "lastOperationTime": "2022-11-25T15:38:28.135Z"
    },
    "operations": [
        {
            "orderId": "btid2384983",
            "operationId": "3470744",
            "channel": "ECOMMERCE",
            "operationType": "CAPTURE",
            "operationResult": "AUTHORIZED",
            "operationTime": "2022-11-25T15:38:28.135Z",
            "paymentMethod": "CARD",
            "paymentCircuit": "VISA",
            "paymentInstrumentInfo": "***6152",
            "paymentEndToEndId": "e723hedsdew",
            "cancelledOperationId": "",
            "operationAmount": "3545",
            "operationCurrency": "EUR",
            "customerInfo": {
                "cardHolderName": "Mauro Morandi",
                "cardHolderEmail": "mauro.morandi@nexi.it",
                "billingAddress": {
                    "name": "Mario Rossi",
                    "street": "Piazza Maggiore, 1",
                    "additionalInfo": "Quinto Piano, Scala B",
                    "city": "Bologna",
                    "postCode": "40124",
                    "province": "BO",
                    "country": "ITA"
                },
                "shippingAddress": {
                    "name": "Mario Rossi",
                    "street": "Piazza Maggiore, 1",
                    "additionalInfo": "Quinto Piano, Scala B",
                    "city": "Bologna",
                    "postCode": "40124",
                    "province": "BO",
                    "country": "ITA"
                },
                "mobilePhoneCountryCode": "39",
                "mobilePhone": "3280987654",
                "homePhone": 391231234567,
                "workPhone": 391231234567,
                "cardHolderAcctInfo": {
                    "chAccDate": "2019-02-11T00:00:00.000Z",
                    "chAccAgeIndicator": "01",
                    "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                    "chAccChangeIndicator": "01",
                    "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                    "chAccPwChangeIndicator": "01",
                    "nbPurchaseAccount": 0,
                    "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                    "destinationAddressUsageIndicator": "01",
                    "destinationNameIndicator": "01",
                    "txnActivityDay": 0,
                    "txnActivityYear": 0,
                    "provisionAttemptsDay": 0,
                    "suspiciousAccActivity": "01",
                    "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                    "paymentAccIndicator": "0"
                },
                "merchantRiskIndicator": {
                    "deliveryEmail": "john.doe@email.com",
                    "deliveryTimeframe": "01",
                    "giftCardAmount": {
                        "value": 100,
                        "currency": "EUR"
                    },
                    "giftCardCount": 0,
                    "preOrderDate": "2019-02-11T00:00:00.000Z",
                    "preOrderPurchaseIndicator": "01",
                    "reorderItemsIndicator": "01",
                    "shipIndicator": "01"
                }
            },
            "warnings": [
                {
                    "code": "TRA001",
                    "description": "3DS warning"
                }
            ],
            "paymentLinkId": "234244353",
            "additionalData": {
                "authorizationCode": "647189",
                "cardCountry": "ITA",
                "threeDS": "FULL_SECURE",
                "schemaTID": "MCS01198U",
                "multiCurrencyConversion": {
                    "amount": "2662",
                    "currency": "JPY",
                    "exchangeRate": "0.007510523"
                }
            }
        }
    ],
    "paymentLinks": [
        {
            "linkId": "92864835",
            "amount": "3545",
            "expirationDate": "2022-09-01T00:00:00.000Z",
            "link": "https://{gateway_hosted_page}",
            "paidByOperationId": "3470744"
        }
    ]
}

    Find Operation by ID

    GET /operations/{operationId}

    Parameters

    • X-API-KEYstringrequired
    • Correlation-Idstring (uuid)required
    • operationIdstringrequired

      Operation id

    Find Operation by ID

    var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/operations/21345");
var request = new RestRequest(Method.GET);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

    Responses

    • 200Operation foundoptional
      • orderIdstringoptional

        Merchant order id, unique in the merchant domain

        example: btid2384983
      • operationIdstringoptionalexample: 3470744
      • channelstringoptional

        It indicates the originating channel:

        • ECOMMERCE - carholder initiated operation through an online channel.
        • POS - carholder initiated operation through a physical POS.
        • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

        ECOMMERCE, POS, BACKOFFICE

        example: ECOMMERCE
      • operationTypestringoptional

        It indicates the purpose of the request:

        • AUTHORIZATION - any authorization with explicit capture
        • CAPTURE - a captured authorization or an implicit captured payment
        • VOID - reversal of an authorization
        • REFUND - refund of a captured amount
        • CANCEL - the rollback of an capture, refund.

        AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

        example: CAPTURE
      • operationResultstringoptional

        Transaction output:

        • 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

        AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

        example: AUTHORIZED
      • operationTimestringoptional

        Operation time

        example: 2022-11-25T15:38:28.135Z
      • paymentMethodstringoptional
        • CARD - Any card circuit
        • APM - Alternative payment method

        CARD, APM

        example: CARD
      • paymentCircuitstringoptional

        one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

        example: VISA
      • paymentInstrumentInfostringoptional

        Payment instrument information

        example: ***6152
      • paymentEndToEndIdstringoptional

        It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

        example: e723hedsdew
      • cancelledOperationIdstringoptional

        Operation id to be undone

      • operationAmountstringoptional

        Operation amount in the payment currency

        example: 3545
      • operationCurrencystringoptional

        Payment currency

        example: EUR
      • customerInfoobjectoptional
        • cardHolderNamestringrequiredexample: Mauro Morandi
        • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
        • billingAddressobjectoptional
          • namestringoptionalexample: Mario Rossi
          • streetstringoptionalexample: Piazza Maggiore, 1
          • additionalInfostringoptionalexample: Quinto Piano, Scala B
          • citystringoptionalexample: Bologna
          • postCodestringoptionalexample: 40124
          • provincestringoptionalexample: BO
          • countrystringoptional

            ISO 3166-1 alpha-3

            example: ITA
        • shippingAddressobjectoptional
          • namestringoptionalexample: Mario Rossi
          • streetstringoptionalexample: Piazza Maggiore, 1
          • additionalInfostringoptionalexample: Quinto Piano, Scala B
          • citystringoptionalexample: Bologna
          • postCodestringoptionalexample: 40124
          • provincestringoptionalexample: BO
          • countrystringoptional

            ISO 3166-1 alpha-3

            example: ITA
        • mobilePhoneCountryCodestringoptionalexample: 39
        • mobilePhonestringoptionalexample: 3280987654
        • homePhonestringoptional

          The home phone number provided by the Cardholder.

          example: 391231234567
        • workPhonestringoptional

          The work phone number provided by the Cardholder.

          example: 391231234567
        • cardHolderAcctInfoobjectoptional
          • chAccDatestringoptional

            Date that the cardholder opened the account with the 3DS Requestor.

            example: 2019-02-11T00:00:00.000Z
          • chAccAgeIndicatorstringoptional

            Length of time that the cardholder has had the account with the 3DS Requestor.

            example: 01
          • chAccChangeDatestringoptional

            Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

            example: 2019-02-11T00:00:00.000Z
          • chAccChangeIndicatorstringoptional

            Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

            example: 01
          • chAccPwChangeDatestringoptional

            Date that cardholder's account with the 3DS Requestor had a password change or account reset.

            example: 2019-02-11T00:00:00.000Z
          • chAccPwChangeIndicatorstringoptional

            Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

            example: 01
          • nbPurchaseAccountnumberoptional

            Number of purchases with this cardholder account during the previous six months.

            example: 0
          • destinationAddressUsageDatestringoptional

            Date when the shipping address used for this transaction was first used with the 3DS Requestor.

            example: 2019-02-11T00:00:00.000Z
          • destinationAddressUsageIndicatorstringoptional

            Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

            example: 01
          • destinationNameIndicatorstringoptional

            Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

            example: 01
          • txnActivityDaynumberoptional

            Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

            example: 0
          • txnActivityYearnumberoptional

            Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

            example: 0
          • provisionAttemptsDaynumberoptional

            Number of Add Card attempts in the last 24 hours.

            example: 0
          • suspiciousAccActivitystringoptional

            Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

            example: 01
          • paymentAccAgeDatestringoptional

            Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

            example: 2019-02-11T00:00:00.000Z
          • paymentAccIndicatorstringoptional

            Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

            example: 0
        • merchantRiskIndicatorobjectoptional
          • deliveryEmailstringoptional

            For Electronic delivery, the email address to which the merchandise was delivered.

            example: john.doe@email.com
          • deliveryTimeframestringoptional

            Indicates the merchandise delivery timeframe.

            example: 01
          • giftCardAmountobjectoptional
            • valuenumberoptional

              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).

              example: 100
            • currencystringoptional

              For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

              example: EUR
          • giftCardCountnumberoptional

            For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

            example: 0
          • preOrderDatestringoptional

            For a pre-ordered purchase, the expected date that the merchandise will be available.

            example: 2019-02-11T00:00:00.000Z
          • preOrderPurchaseIndicatorstringoptional

            Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

            example: 01
          • reorderItemsIndicatorstringoptional

            Indicates whether the cardholder is reordering previously purchased merchandise.

            example: 01
          • shipIndicatorstringoptional

            Indicates shipping method chosen for the transaction.

            example: 01
      • warningsarrayoptional
        • codestringoptionalexample: TRA001
        • descriptionstringoptionalexample: 3DS warning
      • paymentLinkIdstringoptional

        PayByLink id used for correlating this operation with the original link.

        example: 234244353
      • additionalDataobjectoptional

        Map of additional fields specific to the chosen payment method

    • 401Unauthorizedoptional
    • 404Operation not foundoptional
    • 500Internal Server Erroroptional
      • errorsarrayoptional
        • codestringoptionalexample: GW0001
        • descriptionstringoptionalexample: Invalid merchant URL
    {
    "orderId": "btid2384983",
    "operationId": "3470744",
    "channel": "ECOMMERCE",
    "operationType": "CAPTURE",
    "operationResult": "AUTHORIZED",
    "operationTime": "2022-11-25T15:38:28.135Z",
    "paymentMethod": "CARD",
    "paymentCircuit": "VISA",
    "paymentInstrumentInfo": "***6152",
    "paymentEndToEndId": "e723hedsdew",
    "cancelledOperationId": "",
    "operationAmount": "3545",
    "operationCurrency": "EUR",
    "customerInfo": {
        "cardHolderName": "Mauro Morandi",
        "cardHolderEmail": "mauro.morandi@nexi.it",
        "billingAddress": {
            "name": "Mario Rossi",
            "street": "Piazza Maggiore, 1",
            "additionalInfo": "Quinto Piano, Scala B",
            "city": "Bologna",
            "postCode": "40124",
            "province": "BO",
            "country": "ITA"
        },
        "shippingAddress": {
            "name": "Mario Rossi",
            "street": "Piazza Maggiore, 1",
            "additionalInfo": "Quinto Piano, Scala B",
            "city": "Bologna",
            "postCode": "40124",
            "province": "BO",
            "country": "ITA"
        },
        "mobilePhoneCountryCode": "39",
        "mobilePhone": "3280987654",
        "homePhone": 391231234567,
        "workPhone": 391231234567,
        "cardHolderAcctInfo": {
            "chAccDate": "2019-02-11T00:00:00.000Z",
            "chAccAgeIndicator": "01",
            "chAccChangeDate": "2019-02-11T00:00:00.000Z",
            "chAccChangeIndicator": "01",
            "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
            "chAccPwChangeIndicator": "01",
            "nbPurchaseAccount": 0,
            "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
            "destinationAddressUsageIndicator": "01",
            "destinationNameIndicator": "01",
            "txnActivityDay": 0,
            "txnActivityYear": 0,
            "provisionAttemptsDay": 0,
            "suspiciousAccActivity": "01",
            "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
            "paymentAccIndicator": "0"
        },
        "merchantRiskIndicator": {
            "deliveryEmail": "john.doe@email.com",
            "deliveryTimeframe": "01",
            "giftCardAmount": {
                "value": 100,
                "currency": "EUR"
            },
            "giftCardCount": 0,
            "preOrderDate": "2019-02-11T00:00:00.000Z",
            "preOrderPurchaseIndicator": "01",
            "reorderItemsIndicator": "01",
            "shipIndicator": "01"
        }
    },
    "warnings": [
        {
            "code": "TRA001",
            "description": "3DS warning"
        }
    ],
    "paymentLinkId": "234244353",
    "additionalData": {
        "authorizationCode": "647189",
        "cardCountry": "ITA",
        "threeDS": "FULL_SECURE",
        "schemaTID": "MCS01198U",
        "multiCurrencyConversion": {
            "amount": "2662",
            "currency": "JPY",
            "exchangeRate": "0.007510523"
        }
    }
}

    Find Operations

    GET /operations

    Find operations created in the given time interval

    Parameters

    • X-API-KEYstringrequired
    • Correlation-Idstring (uuid)required
    • fromTimestringoptional
    • toTimestringoptional
    • maxRecordsnumberoptional
    • channelstringoptional
    • operationTypestringoptional
    • customFieldstringoptional

    Find Operations

    var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/operations?fromTime=SOME_STRING_VALUE&toTime=SOME_STRING_VALUE&maxRecords=SOME_NUMBER_VALUE&channel=ECOMMERCE&operationType=CAPTURE&customField=SOME_STRING_VALUE");
var request = new RestRequest(Method.GET);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

    Responses

    • 200Request successfully processedoptional
      • operationsarrayoptional
        • orderIdstringoptional

          Merchant order id, unique in the merchant domain

          example: btid2384983
        • operationIdstringoptionalexample: 3470744
        • channelstringoptional

          It indicates the originating channel:

          • ECOMMERCE - carholder initiated operation through an online channel.
          • POS - carholder initiated operation through a physical POS.
          • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

          ECOMMERCE, POS, BACKOFFICE

          example: ECOMMERCE
        • operationTypestringoptional

          It indicates the purpose of the request:

          • AUTHORIZATION - any authorization with explicit capture
          • CAPTURE - a captured authorization or an implicit captured payment
          • VOID - reversal of an authorization
          • REFUND - refund of a captured amount
          • CANCEL - the rollback of an capture, refund.

          AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

          example: CAPTURE
        • operationResultstringoptional

          Transaction output:

          • 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

          AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

          example: AUTHORIZED
        • operationTimestringoptional

          Operation time

          example: 2022-11-25T15:38:28.135Z
        • paymentMethodstringoptional
          • CARD - Any card circuit
          • APM - Alternative payment method

          CARD, APM

          example: CARD
        • paymentCircuitstringoptional

          one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

          example: VISA
        • paymentInstrumentInfostringoptional

          Payment instrument information

          example: ***6152
        • paymentEndToEndIdstringoptional

          It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

          example: e723hedsdew
        • cancelledOperationIdstringoptional

          Operation id to be undone

        • operationAmountstringoptional

          Operation amount in the payment currency

          example: 3545
        • operationCurrencystringoptional

          Payment currency

          example: EUR
        • customerInfoobjectoptional
          • cardHolderNamestringrequiredexample: Mauro Morandi
          • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
          • billingAddressobjectoptional
            • namestringoptionalexample: Mario Rossi
            • streetstringoptionalexample: Piazza Maggiore, 1
            • additionalInfostringoptionalexample: Quinto Piano, Scala B
            • citystringoptionalexample: Bologna
            • postCodestringoptionalexample: 40124
            • provincestringoptionalexample: BO
            • countrystringoptional

              ISO 3166-1 alpha-3

              example: ITA
          • shippingAddressobjectoptional
            • namestringoptionalexample: Mario Rossi
            • streetstringoptionalexample: Piazza Maggiore, 1
            • additionalInfostringoptionalexample: Quinto Piano, Scala B
            • citystringoptionalexample: Bologna
            • postCodestringoptionalexample: 40124
            • provincestringoptionalexample: BO
            • countrystringoptional

              ISO 3166-1 alpha-3

              example: ITA
          • mobilePhoneCountryCodestringoptionalexample: 39
          • mobilePhonestringoptionalexample: 3280987654
          • homePhonestringoptional

            The home phone number provided by the Cardholder.

            example: 391231234567
          • workPhonestringoptional

            The work phone number provided by the Cardholder.

            example: 391231234567
          • cardHolderAcctInfoobjectoptional
            • chAccDatestringoptional

              Date that the cardholder opened the account with the 3DS Requestor.

              example: 2019-02-11T00:00:00.000Z
            • chAccAgeIndicatorstringoptional

              Length of time that the cardholder has had the account with the 3DS Requestor.

              example: 01
            • chAccChangeDatestringoptional

              Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

              example: 2019-02-11T00:00:00.000Z
            • chAccChangeIndicatorstringoptional

              Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

              example: 01
            • chAccPwChangeDatestringoptional

              Date that cardholder's account with the 3DS Requestor had a password change or account reset.

              example: 2019-02-11T00:00:00.000Z
            • chAccPwChangeIndicatorstringoptional

              Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

              example: 01
            • nbPurchaseAccountnumberoptional

              Number of purchases with this cardholder account during the previous six months.

              example: 0
            • destinationAddressUsageDatestringoptional

              Date when the shipping address used for this transaction was first used with the 3DS Requestor.

              example: 2019-02-11T00:00:00.000Z
            • destinationAddressUsageIndicatorstringoptional

              Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

              example: 01
            • destinationNameIndicatorstringoptional

              Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

              example: 01
            • txnActivityDaynumberoptional

              Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

              example: 0
            • txnActivityYearnumberoptional

              Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

              example: 0
            • provisionAttemptsDaynumberoptional

              Number of Add Card attempts in the last 24 hours.

              example: 0
            • suspiciousAccActivitystringoptional

              Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

              example: 01
            • paymentAccAgeDatestringoptional

              Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

              example: 2019-02-11T00:00:00.000Z
            • paymentAccIndicatorstringoptional

              Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

              example: 0
          • merchantRiskIndicatorobjectoptional
            • deliveryEmailstringoptional

              For Electronic delivery, the email address to which the merchandise was delivered.

              example: john.doe@email.com
            • deliveryTimeframestringoptional

              Indicates the merchandise delivery timeframe.

              example: 01
            • giftCardAmountobjectoptional
              • valuenumberoptional

                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).

                example: 100
              • currencystringoptional

                For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                example: EUR
            • giftCardCountnumberoptional

              For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

              example: 0
            • preOrderDatestringoptional

              For a pre-ordered purchase, the expected date that the merchandise will be available.

              example: 2019-02-11T00:00:00.000Z
            • preOrderPurchaseIndicatorstringoptional

              Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

              example: 01
            • reorderItemsIndicatorstringoptional

              Indicates whether the cardholder is reordering previously purchased merchandise.

              example: 01
            • shipIndicatorstringoptional

              Indicates shipping method chosen for the transaction.

              example: 01
        • warningsarrayoptional
          • codestringoptionalexample: TRA001
          • descriptionstringoptionalexample: 3DS warning
        • paymentLinkIdstringoptional

          PayByLink id used for correlating this operation with the original link.

          example: 234244353
        • additionalDataobjectoptional

          Map of additional fields specific to the chosen payment method

    • 401Unauthorizedoptional
    • 500Internal Server Erroroptional
      • errorsarrayoptional
        • codestringoptionalexample: GW0001
        • descriptionstringoptionalexample: Invalid merchant URL
    {
    "operations": [
        {
            "orderId": "btid2384983",
            "operationId": "3470744",
            "channel": "ECOMMERCE",
            "operationType": "CAPTURE",
            "operationResult": "AUTHORIZED",
            "operationTime": "2022-11-25T15:38:28.135Z",
            "paymentMethod": "CARD",
            "paymentCircuit": "VISA",
            "paymentInstrumentInfo": "***6152",
            "paymentEndToEndId": "e723hedsdew",
            "cancelledOperationId": "",
            "operationAmount": "3545",
            "operationCurrency": "EUR",
            "customerInfo": {
                "cardHolderName": "Mauro Morandi",
                "cardHolderEmail": "mauro.morandi@nexi.it",
                "billingAddress": {
                    "name": "Mario Rossi",
                    "street": "Piazza Maggiore, 1",
                    "additionalInfo": "Quinto Piano, Scala B",
                    "city": "Bologna",
                    "postCode": "40124",
                    "province": "BO",
                    "country": "ITA"
                },
                "shippingAddress": {
                    "name": "Mario Rossi",
                    "street": "Piazza Maggiore, 1",
                    "additionalInfo": "Quinto Piano, Scala B",
                    "city": "Bologna",
                    "postCode": "40124",
                    "province": "BO",
                    "country": "ITA"
                },
                "mobilePhoneCountryCode": "39",
                "mobilePhone": "3280987654",
                "homePhone": 391231234567,
                "workPhone": 391231234567,
                "cardHolderAcctInfo": {
                    "chAccDate": "2019-02-11T00:00:00.000Z",
                    "chAccAgeIndicator": "01",
                    "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                    "chAccChangeIndicator": "01",
                    "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                    "chAccPwChangeIndicator": "01",
                    "nbPurchaseAccount": 0,
                    "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                    "destinationAddressUsageIndicator": "01",
                    "destinationNameIndicator": "01",
                    "txnActivityDay": 0,
                    "txnActivityYear": 0,
                    "provisionAttemptsDay": 0,
                    "suspiciousAccActivity": "01",
                    "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                    "paymentAccIndicator": "0"
                },
                "merchantRiskIndicator": {
                    "deliveryEmail": "john.doe@email.com",
                    "deliveryTimeframe": "01",
                    "giftCardAmount": {
                        "value": 100,
                        "currency": "EUR"
                    },
                    "giftCardCount": 0,
                    "preOrderDate": "2019-02-11T00:00:00.000Z",
                    "preOrderPurchaseIndicator": "01",
                    "reorderItemsIndicator": "01",
                    "shipIndicator": "01"
                }
            },
            "warnings": [
                {
                    "code": "TRA001",
                    "description": "3DS warning"
                }
            ],
            "paymentLinkId": "234244353",
            "additionalData": {
                "authorizationCode": "647189",
                "cardCountry": "ITA",
                "threeDS": "FULL_SECURE",
                "schemaTID": "MCS01198U",
                "multiCurrencyConversion": {
                    "amount": "2662",
                    "currency": "JPY",
                    "exchangeRate": "0.007510523"
                }
            }
        }
    ]
}

    Refund

    POST /operations/{operationId}/refunds

    Refund or Reversal based on the clearing state, partial or full

    Parameters

    • X-API-KEYstringrequired
    • Idempotency-Keystring (uuid)required
    • Correlation-Idstring (uuid)required
    • operationIdstringrequired

      Operation id

    Refund

    var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/operations/21345/refunds");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Idempotency-Key", "SOME_STRING_VALUE");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

    Request body

      Responses

      • 200Post operation acceptedoptional
        • 400Request rejectedoptional
          • errorsarrayoptional
            • codestringoptionalexample: GW0001
            • descriptionstringoptionalexample: Invalid merchant URL
        • 401Unauthorizedoptional
        • 404Transaction not foundoptional
        • 500Internal Server Erroroptional
          • errorsarrayoptional
            • codestringoptionalexample: GW0001
            • descriptionstringoptionalexample: Invalid merchant URL
        {
    "errors": [
        {
            "code": "GW0001",
            "description": "Invalid merchant URL"
        }
    ]
}

        Capture

        POST /operations/{operationId}/captures

        Payment confirmation

        Parameters

        • X-API-KEYstringrequired
        • Correlation-Idstring (uuid)required
        • operationIdstringrequired

          Operation id

        Capture

        var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/operations/21345/captures");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

        Request body

          Responses

          • 200Post operation acceptedoptional
            • 400Request rejectedoptional
              • errorsarrayoptional
                • codestringoptionalexample: GW0001
                • descriptionstringoptionalexample: Invalid merchant URL
            • 401Unauthorizedoptional
            • 404Transaction not foundoptional
            • 500Internal Server Erroroptional
              • errorsarrayoptional
                • codestringoptionalexample: GW0001
                • descriptionstringoptionalexample: Invalid merchant URL
            {
    "errors": [
        {
            "code": "GW0001",
            "description": "Invalid merchant URL"
        }
    ]
}

            Cancel a capture operation. Does not apply to any other operation types.

            POST /operations/{operationId}/cancels

            Parameters

            • X-API-KEYstringrequired
            • Correlation-Idstring (uuid)required
            • operationIdstringrequired

              Operation id of a capture operation to be cancelled

            Cancel a capture operation. Does not apply to any other operation types.

            var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/operations/3470744/cancels");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

            Request body

            • descriptionstringoptional

              Free text message available to describe the rationale of the cancel.

              example: refund executed by mistake

            Request body

            {
    "description": "refund executed by mistake"
}

            Responses

            • 200Request acceptedoptional
              • 400Request rejectedoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 404Order or operation not foundoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "errors": [
        {
            "code": "GW0001",
            "description": "Invalid merchant URL"
        }
    ]
}

              List of payment methods supported by this merchant together with associated attributes

              GET /payment_methods

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              List of payment methods supported by this merchant together with associated attributes

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/payment_methods");
var request = new RestRequest(Method.GET);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

              Responses

              • 200Request processed successfullyoptional
                • paymentMethodsarrayoptional
                  • circuitstringoptional

                    one of VISA, MASTERCARD, PAYPAL, BANCONTACT, MYBANK etc.

                    example: VISA
                  • methodTypestringoptional
                    • CARD - Card circuit * APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • imageLinkstringoptional

                    Location for the logo of this payment method in SVG format

                    example: https://ngwecomm.nexi.it/monetaweb/static/images/mybank.svg
                  • recurringSupportedbooleanoptionalexample: true
                  • oneClickSupportedbooleanoptionalexample: true
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "paymentMethods": [
        {
            "circuit": "VISA",
            "methodType": "CARD",
            "imageLink": "https://ngwecomm.nexi.it/monetaweb/static/images/mybank.svg",
            "recurringSupported": true,
            "oneClickSupported": true
        }
    ]
}

              MOTO Payment

              POST /orders/moto

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              MOTO Payment

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/moto");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • cardobjectoptional
                • panstringrequired

                  Card PAN

                  example: 23498093745973
                • expiryDatestringrequired

                  Card expiry date in format mmyy

                  example: 0824
                • cvvstringoptional

                  Card Validation Value, when available

                  example: 234
              • captureTypestringoptional

                Overwrites the default confirmation method of the terminal, for card payments only:

                • IMPLICIT - automatic confirmation
                • EXPLICIT - authorization only
                  Default value depends on the terminal configuration.

                IMPLICIT, EXPLICIT

                example: EXPLICIT

              Request body

              {
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "card": {
        "pan": "23498093745973",
        "expiryDate": "0824",
        "cvv": "234"
    },
    "captureType": "EXPLICIT"
}

              Responses

              • 200Payment successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    }
}

              Card Verification

              POST /orders/card_verification

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Card Verification

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/card_verification");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • cardobjectoptional
                • panstringrequired

                  Card PAN

                  example: 23498093745973
                • expiryDatestringrequired

                  Card expiry date in format mmyy

                  example: 0824
                • cvvstringoptional

                  Card Validation Value, when available

                  example: 234

              Request body

              {
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "card": {
        "pan": "23498093745973",
        "expiryDate": "0824",
        "cvv": "234"
    }
}

              Responses

              • 200Payment successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    }
}

              Merchant Initiated Transaction

              POST /orders/mit

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Merchant Initiated Transaction

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/mit");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • contractIdstringrequiredexample: C2834987
              • captureTypestringoptional

                Overwrites the default confirmation method of the terminal, for card payments only:

                • IMPLICIT - automatic confirmation
                • EXPLICIT - authorization only
                  Default value depends on the terminal configuration.

                IMPLICIT, EXPLICIT

                example: EXPLICIT

              Request body

              {
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "contractId": "C2834987",
    "captureType": "EXPLICIT"
}

              Responses

              • 200Payment successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    }
}

              Generates a link to be shared with the cardholder for triggering the payment for the specified order

              POST /orders/paybylink

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Generates a link to be shared with the cardholder for triggering the payment for the specified order

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/paybylink");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • paymentSessionobjectoptional
                • actionTypestringoptional

                  PAY, VERIFY, PREAUTH

                  example: PAY
                • amountstringrequired

                  Amount of the first payment which may be less or equals to the order amount. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • recurrenceobjectoptional
                  • actionstringoptional

                    NO_RECURRING, SUBSEQUENT_PAYMENT, CONTRACT_CREATION, CARD_SUBSTITUTION

                    example: NO_RECURRING
                  • contractIdstringoptionalexample: C2834987
                  • contractTypestringoptional

                    MIT_UNSCHEDULED, MIT_SCHEDULED, CIT

                    example: MIT_UNSCHEDULED
                  • contractExpiryDatestringoptional

                    Used with contractType MIT_SCHEDULED.

                    example: 2023-03-16T00:00:00.000Z
                  • contractFrequencystringoptional

                    Used with contractType MIT_SCHEDULED. Number of days

                    example: 120
                • captureTypestringoptional

                  Overwrites the default confirmation method of the terminal, for card payments only:

                  • IMPLICIT - automatic confirmation
                  • EXPLICIT - authorization only
                    Default value depends on the terminal configuration.

                  IMPLICIT, EXPLICIT

                  example: EXPLICIT
                • exemptionsstringoptional

                  NO_PREFERENCE, CHALLENGE_REQUESTED

                  example: NO_PREFERENCE
                • languagestringrequired

                  Language to be used on the hosted payment page. ISO 639-2

                  example: ita
                • resultUrlstringoptional

                  Merchant URL where the cardholder is redirected once the hosted payment completes

                  example: https://{merchant_result_url}
                • cancelUrlstringoptional

                  Merchant URL where the cardholder is redirected once the hosted payment is abandoned

                  example: https://{merchant_cancel_url}
                • notificationUrlstringoptional

                  Merchant URL where the gateway pushes notifications

                  example: https://{merchant_notification_url}
              • expirationDatestringrequired

                Expiration date. Maximum 90 days after the link creation

                example: 2022-09-01T00:00:00.000Z

              Request body

              {
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "paymentSession": {
        "actionType": "PAY",
        "amount": "3545",
        "recurrence": {
            "action": "NO_RECURRING",
            "contractId": "C2834987",
            "contractType": "MIT_UNSCHEDULED",
            "contractExpiryDate": "2023-03-16T00:00:00.000Z",
            "contractFrequency": "120"
        },
        "captureType": "EXPLICIT",
        "exemptions": "NO_PREFERENCE",
        "language": "ita",
        "resultUrl": "https://{merchant_result_url}",
        "cancelUrl": "https://{merchant_cancel_url}",
        "notificationUrl": "https://{merchant_notification_url}"
    },
    "expirationDate": "2022-09-01T00:00:00.000Z"
}

              Responses

              • 200Link generatedoptional
                • paymentLinkobjectoptional
                  • linkIdstringoptional

                    Unique identifier for this link.

                    example: 92864835
                  • amountstringoptional

                    Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                    example: 3545
                  • expirationDatestringoptional

                    Expiration date.

                    example: 2022-09-01T00:00:00.000Z
                  • linkstringoptional

                    Link to be shared with the customer for doing the payment.

                    example: https://{gateway_hosted_page}
                  • paidByOperationIdstringoptional

                    Operation Id identifying the successful payment related to this link.

                    example: 3470744
                • securityTokenstringoptional

                  Token which may be used for validating the notifications related to this payment

                  example: 2f0ea5059b41414ca3744fe672327d85
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "paymentLink": {
        "linkId": "92864835",
        "amount": "3545",
        "expirationDate": "2022-09-01T00:00:00.000Z",
        "link": "https://{gateway_hosted_page}",
        "paidByOperationId": "3470744"
    },
    "securityToken": "2f0ea5059b41414ca3744fe672327d85"
}

              Cancel a non-paid link.

              POST /paybylink/{linkId}/cancels

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required
              • linkIdstringrequired

                Payment link ID to be cancelled.

              Cancel a non-paid link.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/paybylink/btid2384983/cancels");
var request = new RestRequest(Method.POST);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

              Responses

              • 200Link cancelled.optional
              • 400Request rejectedoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 404Link not foundoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "errors": [
        {
            "code": "GW0001",
            "description": "Invalid merchant URL"
        }
    ]
}

              Finds recurring contracts by customer ID

              GET /contracts/customers/{customerId}

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required
              • customerIdstringrequired

              Finds recurring contracts by customer ID

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/contracts/customers/36451278");
var request = new RestRequest(Method.GET);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

              Responses

              • 200Payment successfuloptional
                • customerIdstringoptional

                  Customer ID

                  example: 36451278
                • contractsarrayoptional
                  • contractIdstringoptionalexample: C2834987
                  • contractTypestringoptional

                    MIT_UNSCHEDULED, MIT_SCHEDULED, CIT

                    example: MIT_UNSCHEDULED
                  • contractExpiryDatestringoptionalexample: 2023-03-16T00:00:00.000Z
                  • contractFrequencystringoptionalexample: 120
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptionalexample: ***6152
              • 401Unauthorizedoptional
              • 404Customer not foundoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "customerId": "36451278",
    "contracts": [
        {
            "contractId": "C2834987",
            "contractType": "MIT_UNSCHEDULED",
            "contractExpiryDate": "2023-03-16T00:00:00.000Z",
            "contractFrequency": "120",
            "paymentMethod": "CARD",
            "paymentCircuit": "VISA",
            "paymentInstrumentInfo": "***6152"
        }
    ]
}

              Disables a contract

              POST /contracts/{contractId}/deactivation

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required
              • contractIdstringrequired

                Recurring contract id

              Disables a contract

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/contracts/C2834987/deactivation");
var request = new RestRequest(Method.POST);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

              Responses

              • 200Deactivation successfuloptional
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "errors": [
        {
            "code": "GW0001",
            "description": "Invalid merchant URL"
        }
    ]
}

              Verify 3DS enrollment. Begin 3-steps flow.

              POST /orders/3steps/init

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Verify 3DS enrollment. Begin 3-steps flow.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/3steps/init");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • cardobjectoptional
                • panstringrequired

                  Card PAN

                  example: 23498093745973
                • expiryDatestringrequired

                  Card expiry date in format mmyy

                  example: 0824
                • cvvstringoptional

                  Card Validation Value, when available

                  example: 234
              • recurrenceobjectoptional
                • actionstringoptional

                  NO_RECURRING, SUBSEQUENT_PAYMENT, CONTRACT_CREATION, CARD_SUBSTITUTION

                  example: NO_RECURRING
                • contractIdstringoptionalexample: C2834987
                • contractTypestringoptional

                  MIT_UNSCHEDULED, MIT_SCHEDULED, CIT

                  example: MIT_UNSCHEDULED
                • contractExpiryDatestringoptional

                  Used with contractType MIT_SCHEDULED.

                  example: 2023-03-16T00:00:00.000Z
                • contractFrequencystringoptional

                  Used with contractType MIT_SCHEDULED. Number of days

                  example: 120
              • exemptionsstringoptional

                NO_PREFERENCE, CHALLENGE_REQUESTED

                example: NO_PREFERENCE

              Request body

              {
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "card": {
        "pan": "23498093745973",
        "expiryDate": "0824",
        "cvv": "234"
    },
    "recurrence": {
        "action": "NO_RECURRING",
        "contractId": "C2834987",
        "contractType": "MIT_UNSCHEDULED",
        "contractExpiryDate": "2023-03-16T00:00:00.000Z",
        "contractFrequency": "120"
    },
    "exemptions": "NO_PREFERENCE"
}

              Responses

              • 200Initialization doneoptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

                • threeDSEnrollmentStatusstringoptional

                  3Ds Server output of 3DS enrollment check for the given card.

                  example: ENROLLED
                • threeDSAuthRequeststringoptional

                  Information to be passed in the 3DS authentication phase. Needed for 3DS1. This value must be passed in the form for triggerring the authentication step described in '#/components/schemas/ChallengeRequest'.

                  example: s51s35g1se3rg16r1gs35d1g53d1g813531818
                • threeDSAuthUrlstringoptional

                  URL for posting the next step from the cardholder browser. The form application/x-www-form-urlencoded must include the fields described in '#/components/schemas/ChallengeRequest' The cardholder will be redirected to the 3DS authentication flow.

                  example: http://www.example.com/payment/nextStep
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    },
    "threeDSEnrollmentStatus": "ENROLLED",
    "threeDSAuthRequest": "s51s35g1se3rg16r1gs35d1g53d1g813531818",
    "threeDSAuthUrl": "http://www.example.com/payment/nextStep"
}

              Validation for 3DS output

              POST /orders/3steps/validation

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Validation for 3DS output

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/3steps/validation");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • operationIdstringoptional

                Identifier of the payment pending.

                example: 3470744
              • threeDSAuthResponsestringoptional

                Encrypted message containing the 3DS authentication result.

                example: ni2178hiekh29830...

              Request body

              {
    "operationId": "3470744",
    "threeDSAuthResponse": "ni2178hiekh29830..."
}

              Responses

              • 200Validation successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

                • threeDSAuthResultobjectoptional
                  • authenticationValuestringoptionalexample: AAIBBjhkYQAAAAAKl4FHdAAAAAA=
                  • cavvAlgorithmstringoptional
                  • ecistringoptionalexample: 05
                  • merchantAcquirerBinstringoptionalexample: 494330
                  • xidstringoptionalexample: RExDQXMtS05EJTt6VlBNRnxdOkY=
                  • statusstringoptionalexample: VALIDATED
                  • vendorcodestringoptional
                  • versionstringoptionalexample: 2.1.0
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    },
    "threeDSAuthResult": {
        "authenticationValue": "AAIBBjhkYQAAAAAKl4FHdAAAAAA=",
        "cavvAlgorithm": "",
        "eci": "05",
        "merchantAcquirerBin": "494330",
        "xid": "RExDQXMtS05EJTt6VlBNRnxdOkY=",
        "status": "VALIDATED",
        "vendorcode": "",
        "version": "2.1.0"
    }
}

              Payment authorization.Complete 3-steps flow.

              POST /orders/3steps/payment

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Payment authorization.Complete 3-steps flow.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/3steps/payment");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • operationIdstringoptionalexample: 230827004180231740
              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • cardobjectoptional
                • panstringrequired

                  Card PAN

                  example: 23498093745973
                • expiryDatestringrequired

                  Card expiry date in format mmyy

                  example: 0824
                • cvvstringoptional

                  Card Validation Value, when available

                  example: 234
              • recurrenceobjectoptional
                • actionstringoptional

                  NO_RECURRING, SUBSEQUENT_PAYMENT, CONTRACT_CREATION, CARD_SUBSTITUTION

                  example: NO_RECURRING
                • contractIdstringoptionalexample: C2834987
                • contractTypestringoptional

                  MIT_UNSCHEDULED, MIT_SCHEDULED, CIT

                  example: MIT_UNSCHEDULED
                • contractExpiryDatestringoptional

                  Used with contractType MIT_SCHEDULED.

                  example: 2023-03-16T00:00:00.000Z
                • contractFrequencystringoptional

                  Used with contractType MIT_SCHEDULED. Number of days

                  example: 120
              • exemptionsstringoptional

                NO_PREFERENCE, CHALLENGE_REQUESTED

                example: NO_PREFERENCE
              • captureTypestringoptional

                Overwrites the default confirmation method of the terminal, for card payments only:

                • IMPLICIT - automatic confirmation
                • EXPLICIT - authorization only
                  Default value depends on the terminal configuration.

                IMPLICIT, EXPLICIT

                example: EXPLICIT
              • threeDSAuthDataobjectoptional
                • threeDSAuthResponsestringoptional

                  3DS authentication result. Provided in the 2-steps flow when the validation phase is not used.

                  example: ni2178hiekh29830...
                • authenticationValuestringoptional

                  Completed for the 3-steps flow, obtained from the validation phase.

                  example: AAIBBjhkYQAAAAAKl4FHdAAAAAA=
                • ecistringoptional

                  Completed for the 3-steps flow, obtained from the validation phase.

                  example: 05
                • xidstringoptional

                  Completed for the 3-steps flow, obtained from the validation phase.

                  example: RExDQXMtS05EJTt6VlBNRnxdOkY=

              Request body

              {
    "operationId": 230827004180231740,
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "card": {
        "pan": "23498093745973",
        "expiryDate": "0824",
        "cvv": "234"
    },
    "recurrence": {
        "action": "NO_RECURRING",
        "contractId": "C2834987",
        "contractType": "MIT_UNSCHEDULED",
        "contractExpiryDate": "2023-03-16T00:00:00.000Z",
        "contractFrequency": "120"
    },
    "exemptions": "NO_PREFERENCE",
    "captureType": "EXPLICIT",
    "threeDSAuthData": {
        "threeDSAuthResponse": "ni2178hiekh29830...",
        "authenticationValue": "AAIBBjhkYQAAAAAKl4FHdAAAAAA=",
        "eci": "05",
        "xid": "RExDQXMtS05EJTt6VlBNRnxdOkY="
    }
}

              Responses

              • 200Payment successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    }
}

              Verify 3DS enrollment. Begin 2-steps flow.

              POST /orders/2steps/init

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Verify 3DS enrollment. Begin 2-steps flow.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/2steps/init");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • cardobjectoptional
                • panstringrequired

                  Card PAN

                  example: 23498093745973
                • expiryDatestringrequired

                  Card expiry date in format mmyy

                  example: 0824
                • cvvstringoptional

                  Card Validation Value, when available

                  example: 234
              • recurrenceobjectoptional
                • actionstringoptional

                  NO_RECURRING, SUBSEQUENT_PAYMENT, CONTRACT_CREATION, CARD_SUBSTITUTION

                  example: NO_RECURRING
                • contractIdstringoptionalexample: C2834987
                • contractTypestringoptional

                  MIT_UNSCHEDULED, MIT_SCHEDULED, CIT

                  example: MIT_UNSCHEDULED
                • contractExpiryDatestringoptional

                  Used with contractType MIT_SCHEDULED.

                  example: 2023-03-16T00:00:00.000Z
                • contractFrequencystringoptional

                  Used with contractType MIT_SCHEDULED. Number of days

                  example: 120
              • exemptionsstringoptional

                NO_PREFERENCE, CHALLENGE_REQUESTED

                example: NO_PREFERENCE

              Request body

              {
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "card": {
        "pan": "23498093745973",
        "expiryDate": "0824",
        "cvv": "234"
    },
    "recurrence": {
        "action": "NO_RECURRING",
        "contractId": "C2834987",
        "contractType": "MIT_UNSCHEDULED",
        "contractExpiryDate": "2023-03-16T00:00:00.000Z",
        "contractFrequency": "120"
    },
    "exemptions": "NO_PREFERENCE"
}

              Responses

              • 200Payment successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

                • threeDSEnrollmentStatusstringoptional

                  3Ds Server output of 3DS enrollment check for the given card.

                  example: ENROLLED
                • threeDSAuthRequeststringoptional

                  Information to be passed in the 3DS authentication phase. Needed for 3DS1. This value must be passed in the form for triggerring the authentication step described in '#/components/schemas/ChallengeRequest'.

                  example: s51s35g1se3rg16r1gs35d1g53d1g813531818
                • threeDSAuthUrlstringoptional

                  URL for posting the next step from the cardholder browser. The form application/x-www-form-urlencoded must include the fields described in '#/components/schemas/ChallengeRequest' The cardholder will be redirected to the 3DS authentication flow.

                  example: http://www.example.com/payment/nextStep
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    },
    "threeDSEnrollmentStatus": "ENROLLED",
    "threeDSAuthRequest": "s51s35g1se3rg16r1gs35d1g53d1g813531818",
    "threeDSAuthUrl": "http://www.example.com/payment/nextStep"
}

              Payment authorization.Complete 2-steps flow.

              POST /orders/2steps/payment

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Payment authorization.Complete 2-steps flow.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/2steps/payment");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • operationIdstringoptionalexample: 230827004180231740
              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • cardobjectoptional
                • panstringrequired

                  Card PAN

                  example: 23498093745973
                • expiryDatestringrequired

                  Card expiry date in format mmyy

                  example: 0824
                • cvvstringoptional

                  Card Validation Value, when available

                  example: 234
              • recurrenceobjectoptional
                • actionstringoptional

                  NO_RECURRING, SUBSEQUENT_PAYMENT, CONTRACT_CREATION, CARD_SUBSTITUTION

                  example: NO_RECURRING
                • contractIdstringoptionalexample: C2834987
                • contractTypestringoptional

                  MIT_UNSCHEDULED, MIT_SCHEDULED, CIT

                  example: MIT_UNSCHEDULED
                • contractExpiryDatestringoptional

                  Used with contractType MIT_SCHEDULED.

                  example: 2023-03-16T00:00:00.000Z
                • contractFrequencystringoptional

                  Used with contractType MIT_SCHEDULED. Number of days

                  example: 120
              • exemptionsstringoptional

                NO_PREFERENCE, CHALLENGE_REQUESTED

                example: NO_PREFERENCE
              • captureTypestringoptional

                Overwrites the default confirmation method of the terminal, for card payments only:

                • IMPLICIT - automatic confirmation
                • EXPLICIT - authorization only
                  Default value depends on the terminal configuration.

                IMPLICIT, EXPLICIT

                example: EXPLICIT
              • threeDSAuthDataobjectoptional
                • threeDSAuthResponsestringoptional

                  3DS authentication result. Provided in the 2-steps flow when the validation phase is not used.

                  example: ni2178hiekh29830...
                • authenticationValuestringoptional

                  Completed for the 3-steps flow, obtained from the validation phase.

                  example: AAIBBjhkYQAAAAAKl4FHdAAAAAA=
                • ecistringoptional

                  Completed for the 3-steps flow, obtained from the validation phase.

                  example: 05
                • xidstringoptional

                  Completed for the 3-steps flow, obtained from the validation phase.

                  example: RExDQXMtS05EJTt6VlBNRnxdOkY=

              Request body

              {
    "operationId": 230827004180231740,
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "card": {
        "pan": "23498093745973",
        "expiryDate": "0824",
        "cvv": "234"
    },
    "recurrence": {
        "action": "NO_RECURRING",
        "contractId": "C2834987",
        "contractType": "MIT_UNSCHEDULED",
        "contractExpiryDate": "2023-03-16T00:00:00.000Z",
        "contractFrequency": "120"
    },
    "exemptions": "NO_PREFERENCE",
    "captureType": "EXPLICIT",
    "threeDSAuthData": {
        "threeDSAuthResponse": "ni2178hiekh29830...",
        "authenticationValue": "AAIBBjhkYQAAAAAKl4FHdAAAAAA=",
        "eci": "05",
        "xid": "RExDQXMtS05EJTt6VlBNRnxdOkY="
    }
}

              Responses

              • 200Payment successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    }
}

              Create Terms and Condition for orders.

              POST /terms_and_conditions

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Create Terms and Condition for orders.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/terms_and_conditions");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • namestringoptional

                Free label to let the merchant identify the termsAndConditions version for audit purposes.

                example: Grand Hotel Mississipi selling conditions v01
              • termsAndConditionsarrayoptional

                Array of terms and conditions in multiple languages.

                • languagestringoptional

                  Language to be used on the termsAndConditions labels, ISO 639-2.

                  example: eng
                • checkMarkLabelstringoptional

                  Text to be showed beside the checkmark of acceptance.

                  example: Confirm to accept terms and conditions
                • linkLabelstringoptional

                  Text of the hyperlink of the T&C detailed text.

                  example: Property Condition
                • textstringoptional

                  Text of the terms and conditions in html format, encoded in Base64.

                  example: PGRpdj48aDM+Q29uZGl0aW9uPGgzPjxwPlRoZSBub24tcmVmdW5kYWJsZSByYXRlIHJlcXVpcmVzIHRoZSBmdWxsIGFtb3VudCB0byBiZSBjaGFyZ2VkIGF0IHRoZSB0aW1lIG9mIGJvb2tpbmc8L3A+PGRpdj4=
                • labelstringoptional

                  Button label for acknowledgment of the text of T&C.

                  example: OK, I got it!

              Request body

              {
    "name": "Grand Hotel Mississipi selling conditions v01",
    "termsAndConditions": [
        {
            "language": "eng",
            "checkMarkLabel": "Confirm to accept terms and conditions",
            "linkLabel": "Property Condition",
            "text": "PGRpdj48aDM+Q29uZGl0aW9uPGgzPjxwPlRoZSBub24tcmVmdW5kYWJsZSByYXRlIHJlcXVpcmVzIHRoZSBmdWxsIGFtb3VudCB0byBiZSBjaGFyZ2VkIGF0IHRoZSB0aW1lIG9mIGJvb2tpbmc8L3A+PGRpdj4=",
            "label": "OK, I got it!"
        }
    ]
}

              Responses

              • 200Terms and conditions createdoptional
                • termsAndConditionsIdstringoptional

                  Unique identifier of terms and conditions.

                  example: aeca2ac3-1d03-4f17-855b-19767f9c4586
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "termsAndConditionsId": "aeca2ac3-1d03-4f17-855b-19767f9c4586"
}

              Retrieve Terms and Condition.

              GET /terms_and_conditions

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Retrieve Terms and Condition.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/terms_and_conditions");
var request = new RestRequest(Method.GET);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

              Responses

              • 200Terms and conditions returnedoptional
                • termsAndConditionsIdstringoptional

                  Unique identifier of terms and conditions.

                  example: aeca2ac3-1d03-4f17-855b-19767f9c4586
                • namestringoptional

                  Free label to let the merchant identify the termsAndConditions version for audit purposes.

                  example: Grand Hotel Mississipi selling conditions v01
                • tecCreationDatestringoptional

                  Timestamp related to creation date for terms and conditions.

                  example: 2023-03-16T00:00:00.000Z
                • termsAndConditionsarrayoptional

                  Array of terms and conditions in multiple languages.

                  • languagestringoptional

                    Language to be used on the termsAndConditions labels, ISO 639-2.

                    example: eng
                  • checkMarkLabelstringoptional

                    Text to be showed beside the checkmark of acceptance.

                    example: Confirm to accept terms and conditions
                  • linkLabelstringoptional

                    Text of the hyperlink of the T&C detailed text.

                    example: Property Condition
                  • textstringoptional

                    Text of the terms and conditions in html format, encoded in Base64.

                    example: PGRpdj48aDM+Q29uZGl0aW9uPGgzPjxwPlRoZSBub24tcmVmdW5kYWJsZSByYXRlIHJlcXVpcmVzIHRoZSBmdWxsIGFtb3VudCB0byBiZSBjaGFyZ2VkIGF0IHRoZSB0aW1lIG9mIGJvb2tpbmc8L3A+PGRpdj4=
                  • labelstringoptional

                    Button label for acknowledgment of the text of T&C.

                    example: OK, I got it!
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              [
    {
        "termsAndConditionsId": "aeca2ac3-1d03-4f17-855b-19767f9c4586",
        "name": "Grand Hotel Mississipi selling conditions v01",
        "tecCreationDate": "2023-03-16T00:00:00.000Z",
        "termsAndConditions": [
            {
                "language": "eng",
                "checkMarkLabel": "Confirm to accept terms and conditions",
                "linkLabel": "Property Condition",
                "text": "PGRpdj48aDM+Q29uZGl0aW9uPGgzPjxwPlRoZSBub24tcmVmdW5kYWJsZSByYXRlIHJlcXVpcmVzIHRoZSBmdWxsIGFtb3VudCB0byBiZSBjaGFyZ2VkIGF0IHRoZSB0aW1lIG9mIGJvb2tpbmc8L3A+PGRpdj4=",
                "label": "OK, I got it!"
            }
        ]
    }
]

              Retrieve Terms and Conditions details.

              GET /terms_and_conditions/{termsAndConditionsId}

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required
              • termsAndConditionsIdstringrequired

              Retrieve Terms and Conditions details.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/terms_and_conditions/36451278");
var request = new RestRequest(Method.GET);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

              Responses

              • 200Terms and conditions returnedoptional
                • termsAndConditionsIdstringoptional

                  Unique identifier of terms and conditions.

                  example: aeca2ac3-1d03-4f17-855b-19767f9c4586
                • namestringoptional

                  Free label to let the merchant identify the termsAndConditions version for audit purposes.

                  example: Grand Hotel Mississipi selling conditions v01
                • tecCreationDatestringoptional

                  Timestamp related to creation date for terms and conditions.

                  example: 2023-03-16T00:00:00.000Z
                • termsAndConditionsarrayoptional

                  Array of terms and conditions in multiple languages.

                  • languagestringoptional

                    Language to be used on the termsAndConditions labels, ISO 639-2.

                    example: eng
                  • checkMarkLabelstringoptional

                    Text to be showed beside the checkmark of acceptance.

                    example: Confirm to accept terms and conditions
                  • linkLabelstringoptional

                    Text of the hyperlink of the T&C detailed text.

                    example: Property Condition
                  • textstringoptional

                    Text of the terms and conditions in html format, encoded in Base64.

                    example: PGRpdj48aDM+Q29uZGl0aW9uPGgzPjxwPlRoZSBub24tcmVmdW5kYWJsZSByYXRlIHJlcXVpcmVzIHRoZSBmdWxsIGFtb3VudCB0byBiZSBjaGFyZ2VkIGF0IHRoZSB0aW1lIG9mIGJvb2tpbmc8L3A+PGRpdj4=
                  • labelstringoptional

                    Button label for acknowledgment of the text of T&C.

                    example: OK, I got it!
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "termsAndConditionsId": "aeca2ac3-1d03-4f17-855b-19767f9c4586",
    "name": "Grand Hotel Mississipi selling conditions v01",
    "tecCreationDate": "2023-03-16T00:00:00.000Z",
    "termsAndConditions": [
        {
            "language": "eng",
            "checkMarkLabel": "Confirm to accept terms and conditions",
            "linkLabel": "Property Condition",
            "text": "PGRpdj48aDM+Q29uZGl0aW9uPGgzPjxwPlRoZSBub24tcmVmdW5kYWJsZSByYXRlIHJlcXVpcmVzIHRoZSBmdWxsIGFtb3VudCB0byBiZSBjaGFyZ2VkIGF0IHRoZSB0aW1lIG9mIGJvb2tpbmc8L3A+PGRpdj4=",
            "label": "OK, I got it!"
        }
    ]
}

              Cancel a T&C not associated to any operation.

              POST /terms_and_conditions/{termsAndConditionsId}/cancels

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required
              • termsAndConditionsIdstringrequired

                Unique identifier of terms and conditions

              Cancel a T&C not associated to any operation.

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/terms_and_conditions/aeca2ac3-1d03-4f17-855b-19767f9c4586/cancels");
var request = new RestRequest(Method.POST);
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
IRestResponse response = client.Execute(request);

              Responses

              • 200T&C cancelled.optional
              • 400Request rejectedoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 404T&C not foundoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "errors": [
        {
            "code": "GW0001",
            "description": "Invalid merchant URL"
        }
    ]
}

              Incremental of a pre-authorization

              POST /incrementals

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Incremental of a pre-authorization

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/incrementals");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • originalOperationIdstringoptional

                Operation Id to be incremented.

                example: 3470744
              • amountstringoptional

                Incremental amount in smallest currency unit.

                example: 100
              • currencystringoptional

                Operation currency.

                example: EUR
              • descriptionstringoptional

                Operation description.

                example: Hotel reservation extended.

              Request body

              {
    "originalOperationId": "3470744",
    "amount": "100",
    "currency": "EUR",
    "description": "Hotel reservation extended."
}

              Responses

              • 200Operation successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    }
}

              Delay Charge

              POST /delay_charges

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Delay Charge

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/delay_charges");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • originalOperationIdstringoptional

                Operation Id for which the delayed charge is applied.

                example: 3470744
              • amountstringoptional

                Delay charge amount in smallest currency unit.

                example: 100
              • currencystringoptional

                Operation currency.

                example: EUR
              • descriptionstringoptional

                Operation description.

                example: Damaged TV in hotel room.

              Request body

              {
    "originalOperationId": "3470744",
    "amount": "100",
    "currency": "EUR",
    "description": "Damaged TV in hotel room."
}

              Responses

              • 200Operation successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    }
}

              No Show

              POST /no_shows

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              No Show

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/no_shows");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • originalOperationIdstringoptional

                Operation Id for which the no show is applied.

                example: 3470744
              • amountstringoptional

                No show amount in smallest currency unit.

                example: 100
              • currencystringoptional

                Operation currency.

                example: EUR
              • descriptionstringoptional

                Operation description.

                example: As per the hotel policy.

              Request body

              {
    "originalOperationId": "3470744",
    "amount": "100",
    "currency": "EUR",
    "description": "As per the hotel policy."
}

              Responses

              • 200Operation successfuloptional
                • operationobjectoptional
                  • orderIdstringoptional

                    Merchant order id, unique in the merchant domain

                    example: btid2384983
                  • operationIdstringoptionalexample: 3470744
                  • channelstringoptional

                    It indicates the originating channel:

                    • ECOMMERCE - carholder initiated operation through an online channel.
                    • POS - carholder initiated operation through a physical POS.
                    • BACKOFFICE - merchant initiated operation. It includes post operations and MIT.

                    ECOMMERCE, POS, BACKOFFICE

                    example: ECOMMERCE
                  • operationTypestringoptional

                    It indicates the purpose of the request:

                    • AUTHORIZATION - any authorization with explicit capture
                    • CAPTURE - a captured authorization or an implicit captured payment
                    • VOID - reversal of an authorization
                    • REFUND - refund of a captured amount
                    • CANCEL - the rollback of an capture, refund.

                    AUTHORIZATION, CAPTURE, VOID, REFUND, CANCEL

                    example: CAPTURE
                  • operationResultstringoptional

                    Transaction output:

                    • 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

                    AUTHORIZED, EXECUTED, DECLINED, DENIED_BY_RISK, THREEDS_VALIDATED, THREEDS_FAILED, PENDING, CANCELED, VOIDED, REFUNDED, FAILED

                    example: AUTHORIZED
                  • operationTimestringoptional

                    Operation time

                    example: 2022-11-25T15:38:28.135Z
                  • paymentMethodstringoptional
                    • CARD - Any card circuit
                    • APM - Alternative payment method

                    CARD, APM

                    example: CARD
                  • paymentCircuitstringoptional

                    one of the payment circuit values returned by the GET payment_methods web service VISA, MC, AMEX, DINERS, GOOGLE_PAY, APPLE_PAY, PAYPAL, BANCONTACT, BANCOMAT_PAY, MYBANK, PIS, AMAZON_PAY, ALIPAY etc.

                    example: VISA
                  • paymentInstrumentInfostringoptional

                    Payment instrument information

                    example: ***6152
                  • paymentEndToEndIdstringoptional

                    It is defined by the circuit to uniquely identify the transaction. Required for circuid reconciliation purposes.

                    example: e723hedsdew
                  • cancelledOperationIdstringoptional

                    Operation id to be undone

                  • operationAmountstringoptional

                    Operation amount in the payment currency

                    example: 3545
                  • operationCurrencystringoptional

                    Payment currency

                    example: EUR
                  • customerInfoobjectoptional
                    • cardHolderNamestringrequiredexample: Mauro Morandi
                    • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                    • billingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • shippingAddressobjectoptional
                      • namestringoptionalexample: Mario Rossi
                      • streetstringoptionalexample: Piazza Maggiore, 1
                      • additionalInfostringoptionalexample: Quinto Piano, Scala B
                      • citystringoptionalexample: Bologna
                      • postCodestringoptionalexample: 40124
                      • provincestringoptionalexample: BO
                      • countrystringoptional

                        ISO 3166-1 alpha-3

                        example: ITA
                    • mobilePhoneCountryCodestringoptionalexample: 39
                    • mobilePhonestringoptionalexample: 3280987654
                    • homePhonestringoptional

                      The home phone number provided by the Cardholder.

                      example: 391231234567
                    • workPhonestringoptional

                      The work phone number provided by the Cardholder.

                      example: 391231234567
                    • cardHolderAcctInfoobjectoptional
                      • chAccDatestringoptional

                        Date that the cardholder opened the account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccAgeIndicatorstringoptional

                        Length of time that the cardholder has had the account with the 3DS Requestor.

                        example: 01
                      • chAccChangeDatestringoptional

                        Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccChangeIndicatorstringoptional

                        Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                        example: 01
                      • chAccPwChangeDatestringoptional

                        Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 2019-02-11T00:00:00.000Z
                      • chAccPwChangeIndicatorstringoptional

                        Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                        example: 01
                      • nbPurchaseAccountnumberoptional

                        Number of purchases with this cardholder account during the previous six months.

                        example: 0
                      • destinationAddressUsageDatestringoptional

                        Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • destinationAddressUsageIndicatorstringoptional

                        Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                        example: 01
                      • destinationNameIndicatorstringoptional

                        Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                        example: 01
                      • txnActivityDaynumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                        example: 0
                      • txnActivityYearnumberoptional

                        Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                        example: 0
                      • provisionAttemptsDaynumberoptional

                        Number of Add Card attempts in the last 24 hours.

                        example: 0
                      • suspiciousAccActivitystringoptional

                        Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                        example: 01
                      • paymentAccAgeDatestringoptional

                        Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 2019-02-11T00:00:00.000Z
                      • paymentAccIndicatorstringoptional

                        Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                        example: 0
                    • merchantRiskIndicatorobjectoptional
                      • deliveryEmailstringoptional

                        For Electronic delivery, the email address to which the merchandise was delivered.

                        example: john.doe@email.com
                      • deliveryTimeframestringoptional

                        Indicates the merchandise delivery timeframe.

                        example: 01
                      • giftCardAmountobjectoptional
                        • valuenumberoptional

                          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).

                          example: 100
                        • currencystringoptional

                          For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                          example: EUR
                      • giftCardCountnumberoptional

                        For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                        example: 0
                      • preOrderDatestringoptional

                        For a pre-ordered purchase, the expected date that the merchandise will be available.

                        example: 2019-02-11T00:00:00.000Z
                      • preOrderPurchaseIndicatorstringoptional

                        Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                        example: 01
                      • reorderItemsIndicatorstringoptional

                        Indicates whether the cardholder is reordering previously purchased merchandise.

                        example: 01
                      • shipIndicatorstringoptional

                        Indicates shipping method chosen for the transaction.

                        example: 01
                  • warningsarrayoptional
                    • codestringoptionalexample: TRA001
                    • descriptionstringoptionalexample: 3DS warning
                  • paymentLinkIdstringoptional

                    PayByLink id used for correlating this operation with the original link.

                    example: 234244353
                  • additionalDataobjectoptional

                    Map of additional fields specific to the chosen payment method

              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "operation": {
        "orderId": "btid2384983",
        "operationId": "3470744",
        "channel": "ECOMMERCE",
        "operationType": "CAPTURE",
        "operationResult": "AUTHORIZED",
        "operationTime": "2022-11-25T15:38:28.135Z",
        "paymentMethod": "CARD",
        "paymentCircuit": "VISA",
        "paymentInstrumentInfo": "***6152",
        "paymentEndToEndId": "e723hedsdew",
        "cancelledOperationId": "",
        "operationAmount": "3545",
        "operationCurrency": "EUR",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "warnings": [
            {
                "code": "TRA001",
                "description": "3DS warning"
            }
        ],
        "paymentLinkId": "234244353",
        "additionalData": {
            "authorizationCode": "647189",
            "cardCountry": "ITA",
            "threeDS": "FULL_SECURE",
            "schemaTID": "MCS01198U",
            "multiCurrencyConversion": {
                "amount": "2662",
                "currency": "JPY",
                "exchangeRate": "0.007510523"
            }
        }
    }
}

              Create Order to initialize a configurable payment page

              POST /orders/build

              Configurable Payment Initialization page. Initializes a payment process using a custom payment page.

              Parameters

              • X-API-KEYstringrequired
              • Correlation-Idstring (uuid)required

              Create Order to initialize a configurable payment page

              var client = new RestClient("https://xpay.nexigroup.com/api/phoenix-0.0/psp/api/v1/orders/build");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Correlation-Id", "SOME_STRING_VALUE");
request.AddHeader("X-API-KEY", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

              Request body

              • merchantUrlstringrequired

                Should have same address of the checkout page where the iframes are encapsulated

                example: https://www.yoursite.com
              • orderobjectoptional
                • orderIdstringrequired

                  Merchant order id, unique in the merchant domain

                  example: btid2384983
                • amountstringrequired

                  Transaction amount in smallest currency unit. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • currencystringrequired

                  Transaction currency. ISO 4217 alphabetic code

                  example: EUR
                • customerIdstringoptional

                  Customer label for this transaction

                  example: mcid97295873
                • descriptionstringoptional

                  Transaction description

                  example: TV LG 3423
                • customFieldstringoptional

                  Additional transaction description

                  example: weekend promotion
                • customerInfoobjectoptional
                  • cardHolderNamestringrequiredexample: Mauro Morandi
                  • cardHolderEmailstringoptionalexample: mauro.morandi@nexi.it
                  • billingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • shippingAddressobjectoptional
                    • namestringoptionalexample: Mario Rossi
                    • streetstringoptionalexample: Piazza Maggiore, 1
                    • additionalInfostringoptionalexample: Quinto Piano, Scala B
                    • citystringoptionalexample: Bologna
                    • postCodestringoptionalexample: 40124
                    • provincestringoptionalexample: BO
                    • countrystringoptional

                      ISO 3166-1 alpha-3

                      example: ITA
                  • mobilePhoneCountryCodestringoptionalexample: 39
                  • mobilePhonestringoptionalexample: 3280987654
                  • homePhonestringoptional

                    The home phone number provided by the Cardholder.

                    example: 391231234567
                  • workPhonestringoptional

                    The work phone number provided by the Cardholder.

                    example: 391231234567
                  • cardHolderAcctInfoobjectoptional
                    • chAccDatestringoptional

                      Date that the cardholder opened the account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccAgeIndicatorstringoptional

                      Length of time that the cardholder has had the account with the 3DS Requestor.

                      example: 01
                    • chAccChangeDatestringoptional

                      Date that the cardholder's account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccChangeIndicatorstringoptional

                      Length of time since the cardholder's account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.

                      example: 01
                    • chAccPwChangeDatestringoptional

                      Date that cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 2019-02-11T00:00:00.000Z
                    • chAccPwChangeIndicatorstringoptional

                      Indicates the length of time since the cardholder's account with the 3DS Requestor had a password change or account reset.

                      example: 01
                    • nbPurchaseAccountnumberoptional

                      Number of purchases with this cardholder account during the previous six months.

                      example: 0
                    • destinationAddressUsageDatestringoptional

                      Date when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • destinationAddressUsageIndicatorstringoptional

                      Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.

                      example: 01
                    • destinationNameIndicatorstringoptional

                      Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction.

                      example: 01
                    • txnActivityDaynumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

                      example: 0
                    • txnActivityYearnumberoptional

                      Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

                      example: 0
                    • provisionAttemptsDaynumberoptional

                      Number of Add Card attempts in the last 24 hours.

                      example: 0
                    • suspiciousAccActivitystringoptional

                      Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.

                      example: 01
                    • paymentAccAgeDatestringoptional

                      Date that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 2019-02-11T00:00:00.000Z
                    • paymentAccIndicatorstringoptional

                      Indicates the length of time that the payment account was enrolled in the cardholder's account with the 3DS Requestor.

                      example: 0
                  • merchantRiskIndicatorobjectoptional
                    • deliveryEmailstringoptional

                      For Electronic delivery, the email address to which the merchandise was delivered.

                      example: john.doe@email.com
                    • deliveryTimeframestringoptional

                      Indicates the merchandise delivery timeframe.

                      example: 01
                    • giftCardAmountobjectoptional
                      • valuenumberoptional

                        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).

                        example: 100
                      • currencystringoptional

                        For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217.

                        example: EUR
                    • giftCardCountnumberoptional

                      For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

                      example: 0
                    • preOrderDatestringoptional

                      For a pre-ordered purchase, the expected date that the merchandise will be available.

                      example: 2019-02-11T00:00:00.000Z
                    • preOrderPurchaseIndicatorstringoptional

                      Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.

                      example: 01
                    • reorderItemsIndicatorstringoptional

                      Indicates whether the cardholder is reordering previously purchased merchandise.

                      example: 01
                    • shipIndicatorstringoptional

                      Indicates shipping method chosen for the transaction.

                      example: 01
                • transactionSummaryarrayoptional
                  • languagestringoptional

                    Language to be used on the transaction summary details, ISO 639-2.

                    example: eng
                  • summaryListarrayoptional
                    • labelstringoptional

                      label of the field

                      example: Number of people
                    • valuestringoptional

                      value

                      example: 4
                • installmentsarrayoptional
                  • datestringoptional

                    Installment time.

                    example: 2022-09-01T00:00:00.000Z
                  • amountstringoptional

                    Installment amount.

                    example: 350
                • termsAndConditionsIdsarrayoptional
              • paymentSessionobjectoptional
                • actionTypestringoptional

                  PAY, VERIFY, PREAUTH

                  example: PAY
                • amountstringrequired

                  Amount of the first payment which may be less or equals to the order amount. 50 EUR is represented as 5000 (2 decimals) 50 JPY is represented as 50 (0 decimals)

                  example: 3545
                • recurrenceobjectoptional
                  • actionstringoptional

                    NO_RECURRING, SUBSEQUENT_PAYMENT, CONTRACT_CREATION, CARD_SUBSTITUTION

                    example: NO_RECURRING
                  • contractIdstringoptionalexample: C2834987
                  • contractTypestringoptional

                    MIT_UNSCHEDULED, MIT_SCHEDULED, CIT

                    example: MIT_UNSCHEDULED
                  • contractExpiryDatestringoptional

                    Used with contractType MIT_SCHEDULED.

                    example: 2023-03-16T00:00:00.000Z
                  • contractFrequencystringoptional

                    Used with contractType MIT_SCHEDULED. Number of days

                    example: 120
                • captureTypestringoptional

                  Overwrites the default confirmation method of the terminal, for card payments only:

                  • IMPLICIT - automatic confirmation
                  • EXPLICIT - authorization only
                    Default value depends on the terminal configuration.

                  IMPLICIT, EXPLICIT

                  example: EXPLICIT
                • exemptionsstringoptional

                  NO_PREFERENCE, CHALLENGE_REQUESTED

                  example: NO_PREFERENCE
                • languagestringrequired

                  Language to be used on the hosted payment page. ISO 639-2

                  example: ita
                • resultUrlstringoptional

                  Merchant URL where the cardholder is redirected once the hosted payment completes

                  example: https://{merchant_result_url}
                • cancelUrlstringoptional

                  Merchant URL where the cardholder is redirected once the hosted payment is abandoned

                  example: https://{merchant_cancel_url}
                • notificationUrlstringoptional

                  Merchant URL where the gateway pushes notifications

                  example: https://{merchant_notification_url}

              Request body

              {
    "merchantUrl": "https://www.yoursite.com",
    "order": {
        "orderId": "btid2384983",
        "amount": "3545",
        "currency": "EUR",
        "customerId": "mcid97295873",
        "description": "TV LG 3423",
        "customField": "weekend promotion",
        "customerInfo": {
            "cardHolderName": "Mauro Morandi",
            "cardHolderEmail": "mauro.morandi@nexi.it",
            "billingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "shippingAddress": {
                "name": "Mario Rossi",
                "street": "Piazza Maggiore, 1",
                "additionalInfo": "Quinto Piano, Scala B",
                "city": "Bologna",
                "postCode": "40124",
                "province": "BO",
                "country": "ITA"
            },
            "mobilePhoneCountryCode": "39",
            "mobilePhone": "3280987654",
            "homePhone": 391231234567,
            "workPhone": 391231234567,
            "cardHolderAcctInfo": {
                "chAccDate": "2019-02-11T00:00:00.000Z",
                "chAccAgeIndicator": "01",
                "chAccChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccChangeIndicator": "01",
                "chAccPwChangeDate": "2019-02-11T00:00:00.000Z",
                "chAccPwChangeIndicator": "01",
                "nbPurchaseAccount": 0,
                "destinationAddressUsageDate": "2019-02-11T00:00:00.000Z",
                "destinationAddressUsageIndicator": "01",
                "destinationNameIndicator": "01",
                "txnActivityDay": 0,
                "txnActivityYear": 0,
                "provisionAttemptsDay": 0,
                "suspiciousAccActivity": "01",
                "paymentAccAgeDate": "2019-02-11T00:00:00.000Z",
                "paymentAccIndicator": "0"
            },
            "merchantRiskIndicator": {
                "deliveryEmail": "john.doe@email.com",
                "deliveryTimeframe": "01",
                "giftCardAmount": {
                    "value": 100,
                    "currency": "EUR"
                },
                "giftCardCount": 0,
                "preOrderDate": "2019-02-11T00:00:00.000Z",
                "preOrderPurchaseIndicator": "01",
                "reorderItemsIndicator": "01",
                "shipIndicator": "01"
            }
        },
        "transactionSummary": [
            {
                "language": "eng",
                "summaryList": [
                    {
                        "label": "Number of people",
                        "value": "4"
                    }
                ]
            }
        ],
        "installments": [
            {
                "date": "2022-09-01T00:00:00.000Z",
                "amount": "350"
            }
        ],
        "termsAndConditionsIds": [
            "16dd6ac6-0791-4c72-b362-85f77f1728a2"
        ]
    },
    "paymentSession": {
        "actionType": "PAY",
        "amount": "3545",
        "recurrence": {
            "action": "NO_RECURRING",
            "contractId": "C2834987",
            "contractType": "MIT_UNSCHEDULED",
            "contractExpiryDate": "2023-03-16T00:00:00.000Z",
            "contractFrequency": "120"
        },
        "captureType": "EXPLICIT",
        "exemptions": "NO_PREFERENCE",
        "language": "ita",
        "resultUrl": "https://{merchant_result_url}",
        "cancelUrl": "https://{merchant_cancel_url}",
        "notificationUrl": "https://{merchant_notification_url}"
    }
}

              Responses

              • 200Payment initialization successfuloptional
                • hostedFieldHtmlstringoptional

                  Payment method in html format, encoded base64, that the merchant shall inject in his page as desired.

                  example: PGRpdj48aDM+Q29uZGl0aW9uPGgzPjxwPlRoZSBub24tcmVmdW5kYWJsZSByYXRlIHJlcXVpcmVzIHRoZSBmdWxsIGFtb3VudCB0byBiZSBjaGFyZ2VkIGF0IHRoZSB0aW1lIG9mIGJvb2tpbmc8L3A+PGRpdj4=
              • 400Invalid request dataoptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              • 401Unauthorizedoptional
              • 500Internal Server Erroroptional
                • errorsarrayoptional
                  • codestringoptionalexample: GW0001
                  • descriptionstringoptionalexample: Invalid merchant URL
              {
    "hostedFieldHtml": "PGRpdj48aDM+Q29uZGl0aW9uPGgzPjxwPlRoZSBub24tcmVmdW5kYWJsZSByYXRlIHJlcXVpcmVzIHRoZSBmdWxsIGFtb3VudCB0byBiZSBjaGFyZ2VkIGF0IHRoZSB0aW1lIG9mIGJvb2tpbmc8L3A+PGRpdj4="
}