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.

Get Companies(Post)

This API enables customers to Get the details of the companies

Status :Production

Get DataSource(Post)

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

Get Purchase Templates(Post)

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

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.

Get Suppliers(Post)

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

Get VCNAuthsReport(Post)

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

GetVCNClearingsReport(Post)

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

GetPurchaseRequestDetails(Post)

This API enables customers to Get the purchase request Details

GetPurchaseTemplateDetails(Post)

This API enables customers to Get the purchase Request Template Details

CancelPurchaseRequests(Post)

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

CreateVCNAuthsReport(Post)

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

CreateVCNClearingsReport(Post)

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

EmailCardImage(Post)

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

SubmitPurchaseRequest(Post)

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

UpdatePurchaseRequest(Post)

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

CancelPurchaseRequests

Status:

Beta

Version:

V2

Product:

ICCP Solutions

CancelPurchaseRequests

Overview

Cancel a virtual card that’s no longer valid or needed. Cancel up to 50 purchase requests in a single API call.

Node	Child Node	Type	Length	Description
Authorization* required	Bearer xxxx* required	string		Authorization Header (Bearer Token)
Content-Type* required	application/json* required	string		Content Type

Node Type								Type	Length	Description
header	msg_id* required							string	12	Unique Source Message ID
	msg_type* required							string	12	Request Type Default TRANSACTION
	msg_function* required							string	50	Function name to be used Default REQ_CANCEL_PURCHASE_REQUESTS
	src_application* required							string	10	Source requesting channel Ex IVR
	target_application* required							string	10	Target application name Ex MC
	timestamp* required							string	30	Timestamp of the request Format DD/MM/YYYY HH:MM:SS
	bank_id* required							string	4	Source Bank Id Ex bankID
body	purchase_request_id* required							array	12

{"NISrvRequest":{"request_cancel_purchase_requests":{"header":{"msg_id":"236001","msg_type":"TRANSACTION","msg_function":"REQ_CANCEL_PURCHASE_REQUESTS","src_application":"IVR","target_application":"WAY4","timestamp":"2020-07-20T10:49:02.366+04:00","bank_id":"NIC"},"body":{"purchase_request_id":["1480449","1480450"]}}}}

{
    "NISrvRequest": {
        "request_cancel_purchase_requests": {
            "header": {
                "msg_id": "236001",
                "msg_type": "TRANSACTION",
                "msg_function": "REQ_CANCEL_PURCHASE_REQUESTS",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2020-07-20T10:49:02.366+04:00",
                "bank_id": "NIC"
            },
            "body": {
                "purchase_request_id": [
                    "1480449",
                    "1480450"
                ]
            }
        }
    }
}

Node	Child Node	Type	Length	Description
Content-Type	application/json	string		Content Type

Node Type								Type	Length	Description
header	msg_id* required							string	12	The msg_id sent in the request will be sent back in response in this field
	msg_type* required							string	12	msg_type sent in the request will be sent back in response in this field
	msg_function* required							string	50	Function name to be used default REP_CANCEL_PURCHASE_REQUESTS
	src_application* required							string	10	The src_application sent in the request will be sent back in response in this field
	target_application* required							string	10	The target_application sent in the request will be sent back in response in this field
	timestamp* required							string	30	Timestamp of the request Format DD/MM/YYYY HH:MM:SS
	bank_id* required							string	4	The bank_id sent in the request will be sent back in response in this field Eg ABCD
	instance_id							string	10	InstanceID
exception_details	application_name							string	20	Application Name
	date_time							string	30	Timestamp of the response
	status							string	1	Status of the request (S/F)
	error_code							string	4	EAI Internal Error Code
	error_description							string	100	Error Description
body	cancel_request_status	purchase_request_id						string	0
		approval_successful						string	0
		error_message						string	0

{"NISrvResponse":{"response_cancel_purchase_requests":{"header":{"msg_id":"236001","msg_type":"TRANSACTION","msg_function":"REP_CANCEL_PURCHASE_REQUESTS","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":{"cancel_request_status":[{"purchase_request_id":"1480449","approval_successful":"true","error_message":" "}]}}}}

{
    "NISrvResponse": {
        "response_cancel_purchase_requests": {
            "header": {
                "msg_id": "236001",
                "msg_type": "TRANSACTION",
                "msg_function": "REP_CANCEL_PURCHASE_REQUESTS",
                "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": {
                "cancel_request_status": [
                    {
                        "purchase_request_id": "1480449",
                        "approval_successful": "true",
                        "error_message": " "
                    }
                ]
            }
        }
    }
}

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