Credit Solutions

Overview

Prepaid card services in NI allow users to access and use prepaid cards in the payment processing system. Prepaid cards are a type of payment card that are loaded with a specific amount of funds, which can be used to make purchases or withdraw cash at locations that accept the card.Users of prepaid card services in a payment processing company can typically:

Version

Get CVV2

Status:

Production

Version:

V2

Product:

Debit Solutions

Overview

CVV2 is a three or four-digit security code that is printed on the back of a credit or debit card. It is used to verify the authenticity of a card during transactions and is typically required for online or over-the-phone purchases.

The API will connect to the card issuer's systems or network and retrieve the CVV2 associated with the provided card number. The API will then return the CVV2 in its response.

How It Works

The "Get CVV2" API allows developers to retrieve the Card Verification Value 2 (CVV2) associated with a specific card number. This can be accomplished by making an HTTPS POST request to the API endpoint, which includes the card number as a parameter in the request body.

https://api-sandbox.network.global

Get CVV2

Status:

Production

Version:

V2

Product:

Debit Solutions
/SB/CardServices/Transaction/V2/GetCVV2
curl --location --request POST '#{PARAM_URL}' --header 'Authorization: Bearer {{ access_token }}' {custom_headers} --data-raw '#{JSON_PAYLOAD}'
curl --location --request GET 'https://api-sandbox.network.global/v1/tokenkc/generate' \--data-raw '#{JSON_PAYLOAD}'
curl --location --request POST 'https://api-sandbox.network.global/v1/tokenkc/generate' \--data-raw '#{JSON_PAYLOAD}'

Node Child Node Type Length Description
Authorization* requiredBearer xxxx* requiredstringAuthorization Header (Bearer Token)
Content-Type* requiredapplication/json* requiredstringContent Type

Node TypeTypeLengthDescription
headermsg_id* requiredstring12Unique Source Message ID
msg_type* requiredstring12Request Type Default TRANSACTION
msg_function* requiredstring50Function name to be used Default REQ_GET_CVV2
src_application* requiredstring10Source requesting channel eg SSP Might change
target_application* requiredstring10Target application name Ex WAY4
timestamp* requiredstring30Timestamp of the request Format DD/MM/YYYY HH:MM:SS
tracking_idstring30Transaction Tracking Id
bank_id* requiredstring4Source Bank Id Ex NIC
bodycard_identifier_id* requiredstring32card identifier
card_identifier_type* requiredstring20CONTRACT_NUMBER or EXID
expiry_date* requiredstring4YYMM ex: 2310

{
    "NISrvRequest": {
        "request_get_cvv2": {
            "header": {
                "msg_id": "223001",
                "msg_type": "TRANSACTION",
                "msg_function": "REQ_GET_CVV2",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2020-07-20T10:49:02.366+04:00",
                "tracking_id": "223001",
                "bank_id": "NIC"
            },
            "body": {
                "card_identifier_id": "99984100148297467162",
                "card_identifier_type": "EXID",
                "expiry_date": "2701"
            }
        }
    }
}

Node Child Node Type Length Description
Content-Typeapplication/jsonstringContent Type

Node TypeTypeLengthDescription
headermsg_id* requiredstring12The msg_id sent in the request will be sent back in response in this field
msg_type* requiredstring12msg_type sent in the request will be sent back in response in this field
msg_function* requiredstring50Function name to be used default REP_GET_CVV2
src_application* requiredstring10The src_application sent in the request will be sent back in response in this field
target_application* requiredstring10The target_application sent in the request will be sent back in response in this field
timestamp* requiredstring30Timestamp of the request Format DD/MM/YYYY HH:MM:SS
bank_id* requiredstring4The bank_id sent in the request will be sent back in response in this field Eg ABCD
instance_idstring10InstanceID
exception_details
bodycard_identifier_id* requiredstring32454545XXXXXX1234
card_identifier_type* requiredstring20CONTRACT_NUMBER or EXID
cvv2* requiredstring
expiry_date* requiredstring

{
    "NISrvResponse": {
        "response_get_cvv2": {
            "header": {
                "msg_id": "236001",
                "msg_type": "TRANSACTION",
                "msg_function": "RES_GET_CVV2",
                "src_application": "IVR",
                "target_application": "CMS",
                "timestamp": "2020-07-20T10:49:02.366+04:00",
                "bank_id": "NIC",
                "instance_id": "InstanceID"
            },
            "exception_details": {
                "application_name": "TCC-ADP",
                "date_time": "2023-02-01T16:39:47.314+04:00",
                "status": "S",
                "error_code": "000",
                "error_description": "Success"
            },
            "body": {
                "card_identifier_id": "454545XXXXXX1234",
                "card_identifier_type": "CONTRACT_NUMBER\/EXID",
                "cvv2": "string",
                "expiry_date": "string"
            }
        }
    }
}

Code Description
200Sample Description
400Bad Request
401Unauthorized
403Forbidden
500Internal Server Error
502Bad gateway
503Scheduled Maintenance
504Gateway Timeout
596Service Not Found