ICCP Solutions

Overview

In Control for Commercial Payments (ICCP) streamlines business transactions using configurable spending controls and enhanced data:

Unique card number for every transaction

A new account number is generated for each transaction and used only once, which gives each purchase its own unique identifier.

Set Transaction Level Controls

Transaction-level authorization lets you define how, where, and when cards are used.

Get enhanced data

Information important to each individual payment is included in each transaction.

 

Automated reconciliation

VCN data is available for reconciliation reporting.

Workflow control

Approval routing for transactions follows the existing approval process - can also be used as a key tool to reinvent your requisition-to-pay process.

Version
Get Companies(Post)

This API enables customers to Get the details of the companies

Status :Production
Version :V2
Product : ICCP Solutions
Try Out   
Get DataSource(Post)

This API enables customers to Get the details of the schema to use in submit purchase request API calls

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
Get Purchase Templates(Post)

This API enables customers to Gets a list of the purchase templates available to use to create a purchase request

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
Get Real Cards(Post)

This API enables customers to quickly and easily view any restrictions on their credit or debit cards, helping them to make informed decisions about their spending.

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
Get Suppliers(Post)

This API enables customers to Get a list of suppliers to whom payments can be made

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
Get VCNAuthsReport(Post)

This API enables customers to Get the authorization report for a VCN

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
GetVCNClearingsReport(Post)

This API enables customers to Get the clearing report for a VCN

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
GetPurchaseRequestDetails(Post)

This API enables customers to Get the purchase request Details

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
GetPurchaseTemplateDetails(Post)

This API enables customers to Get the purchase Request Template Details

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
CancelPurchaseRequests(Post)

This API enables customers to Cancel a virtual card that’s no longer valid or needed

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
CreateVCNAuthsReport(Post)

This API enables customers to create report for authorization transactions performed using a VCN for a specific date range

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
CreateVCNClearingsReport(Post)

This API enables customers to create report for clearing transactions performed using a VCN for a specific date range

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
EmailCardImage(Post)

This API enables customers to send the virtual card image in an email

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
SubmitPurchaseRequest(Post)

This API enables customers to Submit a purchase request to generate a Virtual Card Number

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   
UpdatePurchaseRequest(Post)

This API enables customers to Update a purchase request to generate a Virtual Card Number

Status :Beta
Version :V2
Product : ICCP Solutions
Try Out   

GetVCNClearingsReport

Status:

Beta

Version:

V2

Product:

ICCP Solutions

GetVCNClearingsReport

Overview

Get the clearing report for a VCN using its report ID.

https://api-sandbox.network.global

GetVCNClearingsReport

Status:

Beta

Version:

V2

Product:

ICCP Solutions
/V2/cardservices/GetVCNClearingsReport
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_VCN_CLEARINGS_REPORT
src_application* requiredstring10Source requesting channel Ex IVR
target_application* requiredstring10Target application name Ex MC
timestamp* requiredstring30Timestamp of the request Format DD/MM/YYYY HH:MM:SS
bank_id* requiredstring4Source Bank Id Ex bankID
bodyfrom* requiredstring3First Transaction to review in the report. Index starts with 0
report_id* requiredstring10ID of a report obtained from a Create API call
to* requiredstring4Last Transaction to review in the report.

{
    "NISrvRequest": {
        "request_get_vcn_clearings_report": {
            "header": {
                "msg_id": "236001",
                "msg_type": "ENQUIRY",
                "msg_function": "REQ_GET_VCN_CLEARINGS_REPORT",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2020-07-20T10:49:02.366+04:00",
                "bank_id": "NIC"
            },
            "body": {
                "from": "1",
                "report_id": "Report Id",
                "to": "10"
            }
        }
    }
}

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_VCN_CLEARINGS_REPORT
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_detailsapplication_namestring20Application Name
date_timestring30Timestamp of the response
statusstring1Status of the request (S/F)
error_codestring4EAI Internal Error Code
error_descriptionstring100Error Description
bodyfrom* requiredstring3First Transaction to review in the report. Index starts with 0
has_more* requiredinteger
to* requiredstring4Last transaction to retrieve the report. Max number of transactions per call is 100
report_status* requiredstring
transactionacquirer_icastring
acquirer_ref_datastring
additional_merchant_namestring
approval_codestring
billing_amountstring
billing_currency_codestring
billing_currency_code_descstring
clearing_typestring
company_namestring
company_numberstring
function_codestring
incontrol_issuer_idstring
mccstring
mcc_descriptionstring
merchant_amountstring
merchant_citystring
merchant_countrystring
merchant_country_codestring
merchant_country_code_descstring
merchant_currency_codestring
merchant_currency_code_descstring
merchant_idstring
merchant_namestring
merchant_postal_codestring
merchant_statestring
merchant_state_addressstring
merchant_terminal_idstring
message_reason_codestring
message_typestring
processor_icastring
purchase_request_idstring
realcard_aliasstring
realcard_numberstring
requestorstring
settlement_amountstring
settlement_currency_codestring
settlement_currency_descstring
settlement_datestring
txn_date_timestring
txn_exchange_ratestring
txn_typestring
virtual_card_numberstring

{
    "NISrvResponse": {
        "response_get_vcn_clearings_report": {
            "header": {
                "msg_id": "236001",
                "msg_type": "ENQUIRY",
                "msg_function": "REP_GET_VCN_CLEARINGS_REPORT",
                "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": {
                "from": "1",
                "has_more": 0,
                "to": "10",
                "report_status": "Completed",
                "transaction": [
                    {
                        "acquirer_ica": "777777",
                        "acquirer_ref_data": "00382299507007100011481",
                        "additional_merchant_name": "Merchant Name Add",
                        "approval_code": "111111",
                        "billing_amount": "35.76",
                        "billing_currency_code": "USD",
                        "billing_currency_code_desc": "U.S. DOLLAR",
                        "clearing_type": "Clr Type",
                        "company_name": "ABC Company",
                        "company_number": "100001",
                        "function_code": "200",
                        "incontrol_issuer_id": "1",
                        "mcc": "5511",
                        "mcc_description": "AUTOTRUCK DLRS-SALES, SVC, REPRS, PRTS, LEASING",
                        "merchant_amount": "35.76",
                        "merchant_city": "London",
                        "merchant_country": "United Kingdom",
                        "merchant_country_code": "826",
                        "merchant_country_code_desc": "UNITED STATES",
                        "merchant_currency_code": "EUR",
                        "merchant_currency_code_desc": "EURO CURRENCY UNIT",
                        "merchant_id": "111111111111111",
                        "merchant_name": "111",
                        "merchant_postal_code": "123",
                        "merchant_state": "London",
                        "merchant_state_address": "London",
                        "merchant_terminal_id": "12345678",
                        "message_reason_code": "1401",
                        "message_type": "1240.0",
                        "processor_ica": "322222",
                        "purchase_request_id": "100",
                        "realcard_alias": "Alias1",
                        "realcard_number": "XXXX-XXXX-XXXX-4000",
                        "requestor": "system",
                        "settlement_amount": "20.0",
                        "settlement_currency_code": "840",
                        "settlement_currency_desc": "U.S. DOLLAR",
                        "settlement_date": "2015-06-10",
                        "txn_date_time": "06-10",
                        "txn_exchange_rate": "2.4",
                        "txn_type": "Authorization",
                        "virtual_card_number": "XXXX-XXXX-XXXX-1000"
                    }
                ]
            }
        }
    }
}

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