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
• amount
• currency
• paymentOption.alternativePaymentMethod class containing:
  • paymentMethod: “apmgw_DuitNow“
• deviceDetails class containing: ipAddress
• billingAddress class containing: firstName, lastName, email, country, phone
• userDetails class containing: firstName, lastName, email, country, phone

Example /payment Request

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

The response generates and returns a redirect URL (redirectUrl) to redirect the customer to the payment page, as well as a UPO (userPaymentOptionId) for use in future transactions.

Example /payment Response

{
  "internalRequestId": 1048812248,
  "status": "SUCCESS",
  "errCode": 0,
  "reason": "",
  "merchantId": "979047831696752006",
  "merchantSiteId": "217268",
  "version": "1.0",
  "clientRequestId": "20240508091256",
  "sessionToken": "6aab4a31-1b46-4c5d-aa91-e31c5a71978c",
  "clientUniqueId": "20180327175242",
  "orderId": "442228258",
  "userTokenId": "TestToken",
  "paymentOption": {
    "redirectUrl": "https://gw-apm-globalpayapi.nuvei.com/Home?PaymentToken=535B6DB4E5D58D45D134DCC215FC79D2.27140076",
    "userPaymentOptionId": "110890658",
    "card": {}
  },
  "transactionStatus": "REDIRECT"
}

After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to 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:

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

Example createPayment() Request

sfc.createPayment({

  sessionToken: "<sessiontoken>",
  paymentOption: {
    alternativePaymentMethod: {
      paymentMethod: "apmgw_DuitNow",
      }     
  },
  deviceDetails:{
    ipAddress:"<customer's IP address>"
  },
  billingAddress: {
    firstName: "John",
    lastName: "Smith",
    email: "[email protected]",
    country: "MY",
    phone:"6175551414"
  },
  userDetails: {
    firstName: "John",
    lastName: "Smith",
    email: "[email protected]",
    country: "MY",
    phone:"6175551414"
  },
}, 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 urlDetails.notificationUrl, which Nuvei recommends including in the /openOrder request.

Example Payment Page Request

https://ppp-test.safecharge.com/ppp/purchase.do?merchant_id=979047831696752006&merchant_site_id=217268&user_token=auto&user_token_id=UserID_6859980283&item_open_amount_1=false&item_min_amount_1=1&item_max_amount_1=100&item_name_1=Cashier%20Test%20product&item_amount_1=10&item_quantity_1=1&item_discount_1=0&numberofitems=1&total_tax=0&discount=0&total_amount=10.00&currency=MYR&version=4.0.0&encoding=UTF-8&first_name=test&last_name=test&address1=test&city=test&zip=123456&country=MY&phone1=123456&email=UserID_6859980283%40gmail.com&success_url=https%3A%2F%2Fhome.stefanovweb.eu%2Fresponse.php&pending_url=https%3A%2F%2Fhome.stefanovweb.eu%2Fresponse.php&error_url=https%3A%2F%2Fhome.stefanovweb.eu%2Fresponse.php&notify_url=https%3A%2F%2Fhome.stefanovweb.eu%2Fdmn%2Fdmn.php%3Fdmnorigin%3DCheckSumCalculator&payment_method_mode=filter&payment_method=apmgw_DuitNow&time_stamp=2024-05-08.09%3A21%3A52&checksum=9ace19157ef399c874c65a9bf0ec0c872178b8294dd64576727f10717496f567&

After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to notify_url, which Nuvei recommends including in the request.