Skip to content
Partner

    TokenizationService

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

    Get token from tokenId.

    GET /{tokenizationId}

    Parameters

    • Authorizationstringrequired

      Authorization header using the Bearer scheme.

    • tokenizationIdstringrequired

    Get token from tokenId.

    var client = new RestClient("https://sandbox.unifiedapi.nets.eu/api/v1/tokens//{tokenizationId}");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer REPLACE_BEARER_TOKEN");
IRestResponse response = client.Execute(request);

    Responses

    • 200Successoptional
      • tokenstringoptional
    • 400Bad Requestoptional
      • tokenstringoptional
    • 500Server Erroroptional
      • typestringoptional
      • titlestringoptional
      • statusinteger (int32)optional
      • detailstringoptional
      • instancestringoptional
    {
    "token": "string"
}

    Tokenize card details for future payments.

    POST /

    Parameters

    • Authorizationstringrequired

      Authorization header using the Bearer scheme.

    Tokenize card details for future payments.

    var client = new RestClient("https://sandbox.unifiedapi.nets.eu/api/v1/tokens//");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Authorization", "Bearer REPLACE_BEARER_TOKEN");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

    Request body

    • tokenSecretstringoptional
    • returnUrlstringoptional
    • descriptionstringoptional
    • payPageConfigurationobjectoptional
      • languageinteger (int32)optional

        EN, DK, NL, ET, FI, FR, DE, IT, LV, LT, NO, PL, PT, RU, ES, SE

    • checkoutTextstringoptional
    • merchantInTestbooleanoptional
    • currencyCodeinteger (int32)optional

      AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMW, ZWL, UYI, CHW, CLF, COU, MXV, SSP, CHE

    • terminalIdstringoptional
    • cardDetailsobjectoptional
      • panstringoptional
      • expiryYearinteger (int32)optional
      • expiryMonthinteger (int32)optional
      • validationCodestringoptional
      • issuerstringoptional

    Request body

    {
    "tokenSecret": "string",
    "returnUrl": "string",
    "description": "string",
    "payPageConfiguration": {
        "language": "EN"
    },
    "checkoutText": "string",
    "merchantInTest": true,
    "currencyCode": "AED",
    "terminalId": "string",
    "cardDetails": {
        "pan": "string",
        "expiryYear": 0,
        "expiryMonth": 0,
        "validationCode": "string",
        "issuer": "string"
    }
}

    Responses

    • 201Createdoptional
      • tokenizationIdstringoptional
    • 400Bad Requestoptional
    • 500Server Erroroptional
      • typestringoptional
      • titlestringoptional
      • statusinteger (int32)optional
      • detailstringoptional
      • instancestringoptional
    {
    "tokenizationId": "string"
}

    Tokenize recurring payment details.

    POST /recurring

    Parameters

    • Authorizationstringrequired

      Authorization header using the Bearer scheme.

    Tokenize recurring payment details.

    var client = new RestClient("https://sandbox.unifiedapi.nets.eu/api/v1/tokens//recurring");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("Authorization", "Bearer REPLACE_BEARER_TOKEN");
request.AddParameter("application/json", "{\"REPLACE_REQUEST_BODY\":\"REPLACE_REQUEST_BODY\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

    Request body

    • tokenSecretstringoptional
    • returnUrlstringoptional
    • descriptionstringoptional
    • payPageConfigurationobjectoptional
      • languageinteger (int32)optional

        EN, DK, NL, ET, FI, FR, DE, IT, LV, LT, NO, PL, PT, RU, ES, SE

    • checkoutTextstringoptional
    • merchantInTestbooleanoptional
    • currencyCodeinteger (int32)optional

      AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XDR, XOF, XPF, YER, ZAR, ZMW, ZWL, UYI, CHW, CLF, COU, MXV, SSP, CHE

    • terminalIdstringoptional
    • recurringTypeinteger (int32)optional

      Subscription, CardOnFile

    • paymentNumberstringoptional
    • amountinteger (int32)optional
    • recurringExpiryDatestring (date)optional
    • recurringFrequencyinteger (int32)optional

    Request body

    {
    "tokenSecret": "string",
    "returnUrl": "string",
    "description": "string",
    "payPageConfiguration": {
        "language": "EN"
    },
    "checkoutText": "string",
    "merchantInTest": true,
    "currencyCode": "AED",
    "terminalId": "string",
    "recurringType": "Subscription",
    "paymentNumber": "string",
    "amount": 0,
    "recurringExpiryDate": "2019-08-24",
    "recurringFrequency": 0
}

    Responses

    • 201Createdoptional
      • tokenizationIdstringoptional
    • 400Bad Requestoptional
    • 500Server Erroroptional
      • typestringoptional
      • titlestringoptional
      • statusinteger (int32)optional
      • detailstringoptional
      • instancestringoptional
    {
    "tokenizationId": "string"
}

    Verify a token.

    POST /{tokenizationId}/Verify

    Parameters

    • Authorizationstringrequired

      Authorization header using the Bearer scheme.

    • tokenizationIdstringrequired

    Verify a token.

    var client = new RestClient("https://sandbox.unifiedapi.nets.eu/api/v1/tokens//{tokenizationId}/Verify");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer REPLACE_BEARER_TOKEN");
IRestResponse response = client.Execute(request);

    Responses

    • 200Successoptional
      • tokenizationIdstringoptional
    • 400Bad Requestoptional
      • tokenizationIdstringoptional
    • 500Server Erroroptional
      • typestringoptional
      • titlestringoptional
      • statusinteger (int32)optional
      • detailstringoptional
      • instancestringoptional
    {
    "tokenizationId": "string"
}