CenterFirst- API Integration Document - UAT v3.0.1 (1)
CenterFirst- API Integration Document - UAT v3.0.1 (1)
API Documentation
Powered By
Table of Contents:
URLs
UAT https://ucpbsapi.credopay.info/mms
Production https://api.thecenterfirst.com/mms
Postman Collection
URL /v1/onboarding/merchant
Method POST
Authorization API Key
Request {
"salesInformation": {
"merchantReferenceNumber": "UTTR62160T",
"region": "southregion",
"branchCode": "8754534293"
{
"pan": {
"documentNumber": "YIUOP0470G",
"url": [
"xmlAadhar": {
"documentNumber": "5175XXXXXX13",
"url": [
"https://ucpbs.credopay.info/mer-
chants/kyc/view/xml/tej.xml?mime=text/xml"
]
},
// Plain Aadhar//
"aadhar": {
"documentNumber": "763077839744",
"url": [
"https://ucpbs.credopay.info/mer-
chants/kyc/view/xml/tej.xml?mime=text/xml"
] "title": "Mr",
"dob": "04-10-1996",
"firstName": "AJAI",
"lastName": "TEST",
"address": "Vinoth Kumar K S/O: Kuber Singh NO 42 ABIRAMI NA-
GAR IRUMBULIYUR TAMBARAM WEST Tambaram Tambaram,Kan-
cheepuram Tamil Nadu 600045",
"pincode": "600032",
"mobile": "8754534293",
"phone": "0449843323210",
"email": "[email protected]",
"nationality": "Indian"
}
],
"settlementInformation": [
{
"bankAccountNumber": "139301518840",
"ifsc": "ICIC0001393",
"accountType": "savings"
}
],
"riskProfileName": "new Plan",
"discountRate": [ (Note: Discount rate is Optional)
"posPlan",
"matmPlan",
"upiPlan",
"aepsPlan"
],
"otherDocuments": [
{
"name": "CANCELLED_CHEQUE",
"documentNumber": "139301518840",
"AEPS",
"POS",
"MATM"
],
"deviceModel": "a75",
"deviceSerialNumber": "123T56k712wwder65",
"deviceImeiNumber": "87823921"
}
],
"action": "SUBMIT"
}
Note:
1. Only Device type can also be provided
2. Device Type Standee, Sticker or soundbox can be provided with
welcomekit serial number
3. Only upiVpa also can be provided to activate
Terminal Onboarding
Use the merchant unique reference number or the CPID for onboarding a new/additional terminal under the mer-
chant.
URL /v1/onboarding/terminal
Method POST
Request
[{
"merchantCpid":"CPMS29010007126",
"channel": [
"POS",
"MATM",
"AEPS"
],
"deviceModel": "A75",
"deviceSerialNumber": "A992348025",
"deviceImeiNumber": "9811567891",
"terminalName":"pos",
"latitude": "13.0249539",
"longitude": "80.207336",
"pincode": "600032",
"address": "26B, 3rd Floor, Chennai, EKKATUTHAN-
GAL, Tamil Nadu, 600032",
"pin":"293012",
"action": "SUBMIT"
}]
"deviceType":"sticker/standee/soundbox",
"welcomeKitSerialNo":"CFST0001212",
"upiVpa":"SET@CUB”.
Response [
{
"Status": 200,
"Message": "Terminal created successfully",
"Data": {
"terminalName": "pos",
"terminalReferenceNumber": " CPMS29010007126"
}
}
]
Merchant Update
Merchant data can be updated using the merchant unique reference number or the merchant CPID. The mer-
chant update can be done only if the merchant status is in New entry, Refer back, Approved or Draft.
URL /v1/onboarding/merchant-update/:ID
Method PUT
Request {
"salesInformation": {
"region": " southregion"
},
"companyInformation": {
"legalName": "onboarding API update",
"brandName": "API",
"address": "42,abirami nagar irumbuliyur tamabram chennai",
"pincode": "600032",
"businessType": "INDIVIDUAL",
"establishedYear": "10-12-2020",
"mcc": "5411",
"emailDomain": [
"credopay.com",
"gmail.com"
]
},
"channel": [
"personalInfo": [
{
"pan": {
"documentNumber": "ZZSOD0470G",
"url": [
"https://ucpbs.credopay.info/mer-
chants/kyc/view/649180508b821da294a6a8ce/testaadharjpg_1687257443262.jpg?mime=im-
age/jpeg"
]
},
"xmlAadhar": {
"documentNumber": "7630XXXXXX44",
"url": [
"https://ucpbs.credopay.info/mer-
chants/kyc/view/xml/tej.xml?mime=text/xml"
]
},
// Plain Aadhar//
"aadhar": {
"documentNumber": "763077839744",
"url": [
"https://ucpbs.credopay.info/mer-
chants/kyc/view/xml/tej.xml?mime=text/xml"
Response {
Status: 200,
Message: “Merchant Updated Successfully”,
}
URL /v1/onboarding/terminal-update/ID
Method PUT
Authorization API Key
Request {
"channel": [
"POS”,
“MATM”,
“AEPS”
],
"terminalName":"vinoth updte",
"pincode": "600045",
"address": "26B, 3rd Floor, Chennai, EKKATUTHAN-
GAL, Tamil Nadu, 600032",
"action": "SUBMIT"
}
//** For UPI & Combinations //
"deviceType":"sticker/standee/soundbox",
"welcomeKitSerialNo":"CFST0001212",
"upiVpa":"SET@CUB”
Response {
Status: 200,
Message: “Terminal Updated Successfully”,
}
Terminal Activation
Terminal activation can be done using the terminal reference number or the CPID. The login and password will
be shared in the SMS (plain JSON) and terminal call-back (encrypted).
Note: The password is encrypted using the API key shared without the hyphens. Algorithm used AES CBC 256.
Base 64 decode -> decrypt using AES CBC 256
URL /v1/onboarding/terminal-activate/CPID
Method POST
Authorization API Key
Request {
"reason":"terminal activation"
}
Response
{
Status: 200,
Message: “Terminal Activated successfully”,
}
URL /v1/onboarding/merchantDeactivate/CPID
Method POST
Authorization API Key
Request
{
"reason": "Merchant deactivation"
"type": "DEACTIVATE" / “CLOSE”
Response {
Status: 200,
Message: “Merchant closed successfully”,
}
Terminal Deactivation
Terminal deactivation can be done using the terminal reference number or the terminal CPID. The terminal/de-
vice will be deactivated, the terminal deactivation can be done in any application status.
URL /v1/onboarding/terminal-deactivate/CPID
Method POST
Authorization API Key
Request
{
"reason": "Terminal deactivation"
}
Response
{
Status: 200,
Message: “Terminal Deactivated successfully”,
}
Response
{
"status": "success"
}
URL /v1/onboarding/merchant-detail/CPID
Method GET
Request
Response {
"data": {
"salesInformation": {
"mechantReferenceNumber": "UI-UI-6453745387",
"region": "all region"
},
"companyInformation": {
"legalName": "Federal Fri 2",
"brandName": "Federal Fri 2",
"address": "300",
"pincode": "600032",
"businessType": "Individual",
"gstin": "",
"mcc": "5411",
"channel": [
{
"name": "UPI",
"transactionSets": [
"Sales"
]
}
]
Get Terminals
Upon onboarding a terminal, this can be used to know the status. You can use the terminal reference number or
the terminal CPID to get the status.
URL /v1/onboarding/terminal-detail/CPID
Method GET
Response {
"cpId": "CPST29010007319",
"applicationStatus": "approved",
"transactionStatus": "approved",
"keyExchange": false,
Get MCC
URL /v1/onboarding/mcc?mccCode
Method GET
Response
{
"data": [
{
"mccCode": "5411",
"natureOfBusiness": "grocery stores, supermarkets",
"mccClassification": "emerging"
}
]
}
Method GET
Url v1/onboarding/transactions/status
rrn rrn
crn_u crn_u
RequestHead-
Key Value
ers
Method GET
Response
[
{
"deviceTtype": "mPOS",
"name": " VM30",
},
{
"deviceTtype": "POS",
"name": "A75",
},
Method GET
Response
"channel": [
{
"name": "POS",
"transac-tionSets": [
"sale",
"cash@pos",
"void"
]
},
{
"name": "MATM",
"transac-tionSets": [
"Cashwithdrawal",
"balanceEnquiry"
]
},
{
"name": "UPI",
"transactionSets": [
"sale"
]
}
],
Method POST
Request Body {
"aggregator_id":"CPPF29010000001","CPID":"CPMS29010000001","merchant-
ReferenceNumber":"AGG2127721","status":{"status":"approved"," EkycCom-
ment":{"Pan":"Matched","Aadhar":"Matched","Bank":"Matched","Gst"
:"Matched"},"documentStatus":{"Pan":"EKYC Verified","Aadhar":"EKYC
Verified","Bank":"EKYC Verified","Gst":"EKYC failed"}},"type":"mer-
chant","remarks":"Merchant Approved Successfully"
}
Expected Re-
sponse code 200 Success
Method POST
Request Body {
aggregator_id: CPPF29010000001,CPID:
CPST29010000001,
status: 'activated',
terminalReferencen-
number:'AGG2127721T001',
type: 'terminal_status',
remarks: 'Terminal Activated Successfully',
password: 'UOBDRtbGiObBvcGd1TzV8A==',
login_id: '3000008001'
}
Request Body
{
"rrn": "31582000232",
"is_void": false,
"is_reversed": false,
"is_disputed": false,
"amount": 102,
"card_type": "contactless",
"card_payment_type":"debit",
"card_usage_type":"domestic"
"masked_pan": "476173XXXXXX0010",
"network": "visa",
"payment_method": "card",
"terminal_cpid": "CPST29010000001",
"custom_field1":"PTTM036240",
"custom_field2":"16417950037",
"crn_u":"PTTM036240",
"transaction_type": "purchase",
"merchant_cpid":"CPMS29010000001",
"created_at": "2020-06-08 13:00:00",
"status": "success"
"chargeSlipURL": "https://ucpbs.credopay.info/transac
tions/slip/647fa67c1erf723bw0232a8d"
Expected Response
code 200 Success
10
applicationNumber M String Unique Reference
Number
partnership-Part-
nership
private - Private
Limited Co
public- Public
Limited Co
trusty- Trusty
other- Other
Channels
Key Condition Type Description Values Max Length
Discount Rate
Key Condition Type Description Values Max Length
Settlement Info
Key Condition Type Description Values Max Length
60
terminalName M String Name of the termi-
nal
address M String Terminal Address 120
15
deviceImeiNumber C String IMEI number of
the device
Values Max
Key condition Type Description
Length