Skip to content
XPayItaly

    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
        • cardHolderNamestringoptionalexample: 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
            • cardHolderNamestringoptionalexample: 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
            • cardHolderNamestringoptionalexample: 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
          • cardHolderNamestringoptionalexample: 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
        • cardHolderNamestringoptionalexample: 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
          • cardHolderNamestringoptionalexample: 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
                  • cardHolderNamestringoptionalexample: 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
                    • cardHolderNamestringoptionalexample: 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
                  • cardHolderNamestringoptionalexample: 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
                    • cardHolderNamestringoptionalexample: 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
                  • cardHolderNamestringoptionalexample: 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
                    • cardHolderNamestringoptionalexample: 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
                  • cardHolderNamestringoptionalexample: 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