Implementation

Payment (Deposit)

When the merchant provides the network (card scheme) token and the cryptogram, include the following in the /payments request:

• networkToken class containing:
  • expirationMonth – The network token’s expiration month.
  • expirationYear – The network token’s expiration year.
  • tokenNumber – Alternative to the Primary Account Number (PAN) and unique to each shopper-merchant pairing.
  • cryptogram – (optional)
  • tokenAssuranceLevel – (optional) Value indicating the confidence level of the token-to-Account-PAN binding.
  • tokenRequestorId – (optional) Identifies the token requestor.

Example Non-3DS /payments Request

{
  "processingEntityId": "<<your processing entity id>>",
  "amount": 10.5,
  "currency": "USD",
  "transactionType": "Sale",
  "paymentOption": {
    "store": "buyerToken",
        "networkTokens": {
            "tokenNumber": "4000020951595032",
            "expirationMonth": "12",
            "expirationYear": "28",
            "cryptogram": "ejJRWG9SWWRpU7I1M28DelozSXU",
            "tokenAssuranceLevel": "3",
            "tokenRequestorId": "2"
        }
  },
  "custom": {
    "description": "Some description"
  },
  "deviceDetails": {
    "ipAddress": "<customer's IP address>",
    "browser": {
      "acceptHeader": "Y",
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36",
      "javaEnabled": "true",
      "language": "en-US",
      "colorDepth": "24",
      "screenHeight": "1080",
      "screenWidth": "1920",
      "timeZone": "0",
      "javaScriptEnabled": "true"
    }
  },
  "buyerDetails": {
    "buyerId": "",
    "firstName": "John",
    "lastName": "Smith",
    "companyName": "Nuvei Corp",
    "dateOfBirth": "1978-06-27",
    "email": "[email protected]",
    "phone": "6175551414",
    "billingAddress": {
      "address": "22 Main Street",
      "zip": "02460",
      "city": "Boston",
      "countryCode": "US",
      "phone": "6175551414",
      "addressMatch": "true"
    },
    "shippingAddress": {
      "sameAsBilling": "true",
      "address": "22 Main Street",
      "zip": "02460",
      "city": "Boston",
      "countryCode": "US",
      "phone": "6175551414"
    }
  }
}

Payout (Withdrawal)

When the merchant provides the network (card scheme) token and the cryptogram, include the following in the /payouts request:

• networkToken class containing:
  • expirationMonth – The network token’s expiration month.
  • expirationYear – The network token’s expiration year.
  • tokenNumber
  • tokenAssuranceLevel (optional)
  • tokenRequestorId (optional)

Example /payouts Request

{
  "processingEntityId": "123e4567-e89b-12d3-a456-426614174000",
  "amount": 60,
  "currency": "EUR",
  "paymentOption": {
        "networkTokens": {
            "tokenNumber": "4000020951595032",
            "expirationMonth": "12",
            "expirationYear": "28",
            "tokenAssuranceLevel": "3",
            "tokenRequestorId": "2"
        }
  },
  "buyerDetails": {
    "buyerId": "buyerId123",
    "firstName": "John",
    "lastName": "JSmith",
    "companyName": "Nuvei Corp",
    "locale": "bg-BG",
    "dateOfBirth": "1978-01-01",
    "email": "[email protected]",
    "phone": "+1234567889",
    "billingAddress": {
      "state": "TX",
      "city": "Austin",
      "zip": "78652",
      "countryCode": "US"
    },
    "shippingAddress": {
      "sameAsBilling": true
    }
  }
}