Debit Solutions

Overview

Our one-stop, centralised solution for Debit Card processing is designed to provide you with a seamless and secure payment experience. Whether you are a small business or a large enterprise, our solution is cost-effective, easily configurable and scalable to meet your specific needs.

With our Debit Card processing solution, you can easily accept payments from your customers and enjoy faster access to your funds. Our platform supports all major debit card networks, so you can accept payments from customers regardless of their bank.

Version

Get CVV2

Status:

Production

Version:

V2

Product:

Credit 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:

Credit 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