Skip to main content

Provision Network Token

POST 
/network-tokens

Provision a network token via Visa or MDES.

Request​

Body

required

An object containing payment method details

    processingEntityId uuidrequired

    Processing entityId provided by Nuvei.

    Example: 80aef199-b89a-4d59-ba0c-f2cd3c25d5cd

    paymentOption

    object

    required

    card

    object

    cardNumber passwordrequired

    The full credit card number.

    Possible values: >= 6 characters and <= 20 characters

    Example: 5113981660016597
    expirationMonth Card Expiration - Month (string)required

    The card expiration month.

    Possible values: Value must match regular expression ^(0[1-9]|1[0-2])$

    Example: 06
    expirationYear Card Expiration - Year (string)required

    The card expiration year.

    Possible values: Value must match regular expression ^(\d{4}|\d{2})$

    Example: 2022
    cvv passwordrequired

    The CVV/CVC security code.

    Possible values: <= 4 characters

    Example: 591
    merchantReference Merchant Reference for Payment Token (string)

    Merchant Reference for a business entity (token, subscription, etc.)

    Possible values: <= 50 characters

    Example: MREF_6f06168d-ff6e-448b-8401-30051eb6b1af

Responses​

OK

Schema

    paymentOption

    object

    networkToken

    object

    paymentTokenId string
    tokenNumber password

    Possible values: <= 29 characters

    expirationYear ExpirationYear (string)
    expirationMonth ExpirationMonth (string)
    tokenStatus TokenStatus (string)

    Possible values: <= 40 characters

    tokenUniqueReference TokenUniqueReference (string)

    Possible values: <= 64 characters

    paymentAccountReference PaymentAccountReference (string)
    tokenAssuranceLevel TokenAssuranceLevel (string)

    card

    object

    last4Digits Last4Digits (string)

    Possible values: <= 4 characters

    expirationYear ExpirationYear (string)
    expirationMonth ExpirationMonth (string)
    cardUpdated CardUpdated (string)
    updateReason UpdateReason (string)
    updateDate UpdateDate (string)
    merchantReference Merchant Reference for Payment Token (string)

    Merchant Reference for a business entity (token, subscription, etc.)

    Possible values: <= 50 characters

    Example: MREF_6f06168d-ff6e-448b-8401-30051eb6b1af
    tokenRequestorId TokenRequestorId (string)

    Possible values: <= 15 characters

    result

    object

    required

    status stringrequired

    Possible values: [success, error]

    errors

    object

    code string

    If an error occurred on the request side, an error code is returned in this parameter.

    Possible values: <= 11 characters

    Example: 7000.1000
    reason string

    If an error occurred on the request side, then an error reason is returned in this parameter.

    Possible values: <= 400 characters

    Example: Unexpected error
Loading...