Follow these steps to perform a payment using Nuvei REST API integration:

1. Generate a sessionToken

Press here for details.

2. Send a /payment Request

Perform the payment by sending a /payment request with its mandatory parameters including:

• userTokenId
• currency
• amount
• paymentOption.alternativePaymentMethod class containing:
  • paymentMethod: “apmgw_MobilePay“
• deviceDetails class containing:
  • ipAddress
  • deviceType– Possible values: DESKTOP, SMARTPHONE, TABLET
    You must specify deviceType; otherwise, the correct MobilePay redirectURL is not sent to the customer if a mobile device is used.

• billingAddress class containing: firstName, lastName, email, country
• userDetails class containing: firstName, lastName, email, country, phone
  The phone number must be fully specified, including the country code. For example, for +45 12 34 56 78, you should enter 004512345678.

Example /payment Request

{
  "sessionToken": "<sessionToken from /getSessionToken>",
  "merchantId": "<your merchantId>",
  "merchantSiteId": "<your merchantSiteId>",
  "clientRequestId": "<unique request ID in merchant system>",
  "amount": "200",
  "currency": "DKK",
  "userTokenId": "<unique customer identifier in merchant system>",
  "clientUniqueId": "<unique transaction ID in merchant system>",
  "paymentOption": {
    "alternativePaymentMethod": {
      "paymentMethod": "apmgw_MobilePay"
    }
  },
  "deviceDetails": {
    "ipAddress": "<customer's IP address>",
    "deviceType": "DESKTOP" 
  },
  "billingAddress": {
    "firstName": "John",
    "lastName": "Smith",
    "email": "[email protected]",
    "country": "DK"
  },
  "userDetails": {
    "firstName": "John",
    "lastName": "Smith",
    "email": "[email protected]",
    "country": "DK",
    "phone": "00451235678"
  },
  "timeStamp": "<YYYYMMDDHHmmss>",
  "checksum": "<calculated checksum>"
}

Example /payment Response

The request is processed and returned with transactionStatus: “REDIRECT“. The URL is redirected to the MobilePay application.

  "reason": "",
  "orderId": "38469561",
  "transactionStatus": "REDIRECT",
  "clientRequestId": "D16T6MGO6",
  "internalRequestId": 23398951,
  "merchantDetails": {
    "customField1": "customField1-value",
    "customField2": "customField2-value"
  },
  "version": "1.0",
  "merchantSiteId": "126006",
  "merchantId": "2502136204546424962",
  "clientUniqueId": "LYBJQHEDMYPA",
  "errCode": 0,
  "paymentOption": {
    "redirectUrl": "https://sandprod-products.mobilepay.dk/remote-website/index.html?page=request&id=46ecbfc9-78c5-4bcd-adb2-1eb01eb5a0fb",
    "userPaymentOptionId": "8393691",
    "card": {}
  },
  "sessionToken": "9ef98871-0983-4f3a-889a-d968e431155b",
  "userTokenId": "RGLA9NP9Y414",
  "status": "SUCCESS"
}

After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to the URL provided in urlDetails.notificationUrl, which Nuvei recommends including in the /payment request.

Follow these steps to perform a payment using Nuvei Web SDK integration.

1. Initiate a Session

Before you can submit payment using the client-side Nuvei Web SDK, you need to send the /openOrder API call.

2. Initialize the Web SDK

Instantiate the Web SDK with the sessionToken received from the server call to /openOrder.

3. Create an APM Payment

Send a createPayment() request with its mandatory parameters including:

• sessionToken
• paymentOption.alternativePaymentMethod class containing:
  • paymentMethod: “apmgw_MobilePay“
• deviceDetails class containing: ipAddress
• billingAddress class containing: firstName, lastName, country, email
• userDetails class containing: firstName, lastName, email, country

Example createPayment() Request

sfc.createPayment({
  sessionToken: sessionData.sessionToken,
  paymentOption: {
    alternativePaymentMethod: {
      paymentMethod: "apmgw_MobilePay"
    }
  },
  deviceDetails: {
    ipAddress  : "<customer's IP address>"
  },
  billingAddress: {
    firstName: "John",
    lastName: "Smith",
    email: "[email protected]",
    country: "DK"
  }
  userDetails: {
    firstName: "John",
    lastName: "Smith",
    email: "[email protected]",
    country: "DK"
  }
}, function(res) {
  console.log(res);
})

After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to the URL provided in urlDetails.notificationUrl, which Nuvei recommends including in the /openOrder request.