You can manage and retrieve Account details available for an IFI using the /bundle APIs. To fetch Resource details associated with an Account Holder use /resource APIs.

Get Accounts

Call /bundles endpoint to retrieve all the existing Bundles available for an IFI. The response returns an array of all available Bundles with a unique identifier, id , for each Bundle. Each of these Bundles contain the Account Product details within them.

Endpoint URI

POST	/api/v1/ifi/{ifiID}/bundles

Request parameters

ifiID : Required. Unique identifier of the IFI .

Example

In the following example, all the Bundles available for IFI with the ID 140827 are fetched. The response returns two Bundles:

Account and Payment Product Bundle with the Bundle ID ee64c930-c06f-49cb-9443-84b132b9d4e2. As the name suggests, the Bundle is configured with Account Product ("id": "9e97fc72-d692-4c0a-bccc-ba689954d9af") and Payment Product ("id": "86da4629-9c59-45d9-9c0e-61d78ccb196f").
Account Product Bundle with the Bundle ID 31c30bca-7406-44e0-8d31-26bc3ed8a1ee. As the name suggests, only Account Product ("id": "942a4cf7-3749-4919-b6cb-4a5f2d29c77c") is configured for this Bundle.

Request

Response

cURL sample

curl -X GET \
https://fusion.preprod.zeta.in/api/v1/ifi/140827/bundles \
-H 'Content-Type: application/json' \
-H 'X-Zeta-AuthToken: {{AUTH_TOKEN}}'

JSON sample

[
{
"id": "ee64c930-c06f-49cb-9443-84b132b9d4e2",
"ifiID": 140827,
"vboID": "zeta",
"name": "Account + Payment Product Bundle",
"accountProducts": [
{
"id": "9e97fc72-d692-4c0a-bccc-ba689954d9af",
"productID": "7706229683808022627",
"type": "ACCOUNT",
"programIDs": "",
"ifiID": 140827
}
],
"paymentProducts": [
{
"id": "86da4629-9c59-45d9-9c0e-61d78ccb196f",
"productID": "baefec67",
"type": "PAYMENT",
"programIDs": "",
"ifiID": 140827
}
],
"status": "active",
"createdAt": "Nov 9, 2019 10:19:49 AM",
"updatedAt": "Nov 28, 2019 2:01:13 PM"
},
{
"id": "31c30bca-7406-44e0-8d31-26bc3ed8a1ee",
"ifiID": 140827,
"vboID": "zeta",
"name": "Account Product Bundle",
"accountProducts": [
{
"id": "942a4cf7-3749-4919-b6cb-4a5f2d29c77c",
"productID": "4732811754742423772",
"type": "ACCOUNT",
"programIDs": "",
"ifiID": 140827
}
],
"paymentProducts": [],
"status": "active",
"createdAt": "Nov 12, 2019 11:36:32 AM",
"updatedAt": "Nov 28, 2019 2:02:06 PM"
}
]

Get accounts Details

A Resource is responsible for digital authentication of any transaction - financial or non-financial. An Account issued to an Account Holder includes Resource, which is internally mapped to a phone number and the card.

Fusion provides two APIs to fetch Resource details— by Resource ID, or by Vector. Each API requires different path parameters, and is explained with examples in detail below:

Get accounts by Resource ID

When you issue a Bundle to an Account Holder, a Resource is created with a unique identifier that represents the Account Holder in Fusion's ecosystem. To get the details of the Resource, call the /resources API and pass the identifier, Resource ID, as path parameter.

Endpoint URI

GET	/api/v1/ifi/{ifiID}/resources/{resourceID}

Request Parameters

ifiID: Required. Unique identifier of the IFI.
resourceID: Required. Unique identifier of the Resource for whom the details are fetched.

Example

In the below example, we fetch details for a Resource with ID d0a21d7b-38ad-4ab1-88a4-fc17c2189244. The response returns details of a Resource Product named "Prepaid Card Resource Product" with the correspondingForm Factor Product details.

Request

Response

cURL sample

curl -X GET \
https://fusion.preprod.zeta.in/api/v1/ifi/140827/resources/d0a21d7b-38ad-4ab1-88a4-fc17c2189244 \
-H 'X-Zeta-AuthToken: {{AUTH_TOKEN}}' \

JSON sample

{
"ifi": 140827,
"id": "d0a21d7b-38ad-4ab1-88a4-fc17c2189244",
"resourceProductId": "2ac114f3",
"resourceProduct": {
"ifi": 140827,
"id": "2ac114f3",
"code": "RPABC001",
"name": "Prepaid Card Resource Product",
"description": "Prepaid RuPay card resource product for ABC",
"formFactorProducts": [
{
"ifi": 140827,
"id": "4f6ed594",
"code": "CMSFF100",
"name": "ABC Form Factor Pr100",
"description": "Mobile Form Factor Product for ABC",
"type": "phoneNumber",
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"provider": "PMS",
"skuID": "ABC_MS",
"tags": [],
"attributes": {},
"issuanceStatus": "ACTIVE",
"paymentStatus": "ACTIVE",
"createdAt": "Nov 15, 2019 5:28:13 PM",
"modifiedAt": "Nov 15, 2019 5:28:13 PM",
"headers": {
"tenantID": "140827",
"object": "140827@tenant.zeta.in"
}
},
{
"ifi": 140827,
"id": "66abce21",
"code": "CMSFF001",
"name": "ABC Form Factor Product 001",
"description": "Card Form Factor Product for ABC",
"type": "card",
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"provider": "CMS",
"skuID": "ABC_MS",
"tags": [],
"attributes": {},
"issuanceStatus": "ACTIVE",
"paymentStatus": "ACTIVE",
"createdAt": "Nov 20, 2019 4:33:37 PM",
"modifiedAt": "Nov 20, 2019 4:33:37 PM",
"headers": {
"tenantID": "140827",
"object": "140827@tenant.zeta.in"
}
}
],
"tags": [],
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"status": "ACTIVE",
"createdAt": "Nov 20, 2019 4:36:45 PM",
"modifiedAt": "Nov 28, 2019 7:20:03 PM",
"headers": {}
},
"targetURI": "account://375e2078-fd4f-4a81-ac87-b32b2b3f4e5a",
"formFactors": [
{
"id": "13c3c5d2-6c06-4187-888c-b781b0cc24de",
"ifi": 140827,
"formFactorProductID": "4f6ed594",
"formFactorID": "+919583170190",
"targetURI": "account:375e2078-fd4f-4a81-ac87-b32b2b3f4e5a",
"tags": [],
"attributes": {},
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"status": "ACTIVE",
"createdAt": "Jan 6, 2020 2:09:28 PM",
"modifiedAt": "Jan 6, 2020 2:09:28 PM",
"headers": {}
},
{
"id": "1dd05c2c-b9ed-4482-9191-83a2c8468c21",
"ifi": 140827,
"formFactorProductID": "66abce21",
"formFactorID": "051ca6cf-2bfa-4a9a-9353-5c3d4aae8ba8",
"targetURI": "account:375e2078-fd4f-4a81-ac87-b32b2b3f4e5a",
"tags": [],
"attributes": {},
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"status": "ACTIVE",
"createdAt": "Jan 6, 2020 2:09:29 PM",
"modifiedAt": "Jan 6, 2020 2:09:29 PM",
"headers": {}
}
],
"tags": [],
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"attributes": {},
"status": "ACTIVE",
"createdAt": "Jan 6, 2020 2:09:28 PM",
"modifiedAt": "Jan 6, 2020 2:09:28 PM",
"headers": {}
}

Get accounts by Vector

Vectors are identifiers, like phone number and email, that can be used to fetch details of an Account Holder. Here, we call the /resourceByVector API and use Account Holder's ID as a Vector to fetch their Resource details. Fusion generates the Account Holder ID when you create an Account Holder.

Endpoint URI

GET	/api/v1/ifi/{ifiID}/resourceByVector?vectorType={vectorType}&vectorValue={vectorValue}

Input Parameters

ifiID: Required. Unique identifier of the IFI.
vectorType: Required. The type of Vector against which Resource details are fetched. Supported Vector types: phone number and email.
vectorValue: Required. Value of the Vector depending on the vectorType specified. Since, only Account Holder is currently supported, hence specify Account Holder ID here.
view: Optional. Parameter to filter the results. The following views are supported:
- BASIC: Default view. Returns details of all the active and inactive Form Factors associated with the Resource.
- EXPANDED: Returns details of all the active, inactive and deleted Form Factors associated with the Resource.

Example

In the following example, we fetch Resource details of an Account Holder with the ID d793ba95-e92d-472b-a44d-75cf7631277c. Response for both BASIC and EXPANDED views are shown here:

BASIC view shows only the active Form Factor ("formFactorID": "40323ba2-f091-4d24-bddb-cc5663501bb2")
EXPANDED view shows the active Form Factor ("formFactorID": "40323ba2-f091-4d24-bddb-cc5663501bb2") as well as deleted Form Factor ("formFactorID": "+913815141711").

Request

Response (BASIC view)

Response (EXPANDED view)

cURL sample

curl -X GET \
https://fusion.preprod.zeta.in/api/v1/ifi/140827/resourceByVector/p/+918830145227' \
-H 'X-Zeta-AuthToken: {{AUTH_TOKEN}}' \

JSON sample

{
"ifi": 140827,
"requestId": "b9382c61-c365-4f3d-988e-cffa7b3f886a_4fa18593-d2d9-4bf3-bea7-7f6deb9f2ca4",
"id": "d793ba95-e92d-472b-a44d-75cf7631277c",
"resourceProductId": "2ac114f3",
"resourceProduct": {
"ifi": 140827,
"id": "2ac114f3",
"code": "RPFAM001",
"name": "Prepaid Card Resource Product",
"description": "Prepaid RuPay card resource product for ABC",
"formFactorProducts": [
{
"ifi": 140827,
"id": "4f6ed594",
"code": "CMSFF100",
"name": "ABC Form Factor Pr100",
"description": "Mobile Form Factor Product for ABC",
"type": "phoneNumber",
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"provider": "PMS",
"skuID": "ABC_FAMPAY_MS",
"tags": [],
"attributes": {},
"issuanceStatus": "ACTIVE",
"paymentStatus": "ACTIVE",
"createdAt": "Nov 15, 2019 5:28:13 PM",
"modifiedAt": "Nov 15, 2019 5:28:13 PM",
"headers": {
"tenantID": "140827",
"object": "140827@tenant.zeta.in"
}
},
{
"ifi": 140827,
"id": "66abce21",
"code": "CMSFF001",
"name": "ABC Form Factor Product 001",
"description": "Card Form Factor Product for ABC",
"type": "card",
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"provider": "CMS",
"skuID": "ABC_FAMPAY_MS",
"tags": [],
"attributes": {},
"issuanceStatus": "ACTIVE",
"paymentStatus": "ACTIVE",
"createdAt": "Nov 20, 2019 4:33:37 PM",
"modifiedAt": "Nov 20, 2019 4:33:37 PM",
"headers": {
"tenantID": "140827",
"object": "140827@tenant.zeta.in"
}
}
],
"tags": [],
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"status": "ACTIVE",
"createdAt": "Nov 20, 2019 4:36:45 PM",
"modifiedAt": "Nov 28, 2019 7:20:03 PM",
"headers": {}
},
"targetURI": "account://8780dd20-8171-4849-90e6-8752b2e5b675",
"formFactors": [
{
"id": "b3121006-f2e1-4d8c-ad64-f7d8086aa0da",
"ifi": 140827,
"formFactorProductID": "66abce21",
"formFactorID": "40323ba2-f091-4d24-bddb-cc5663501bb2",
"targetURI": "account:account://8780dd20-8171-4849-90e6-8752b2e5b675",
"tags": [],
"attributes": {},
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"status": "ACTIVE",
"createdAt": "May 11, 2020 8:24:07 AM",
"modifiedAt": "May 11, 2020 8:24:07 AM",
"headers": {}
}
],
"tags": [],
"vectors": [
"vector://ACCOUNTHOLDER/c99824ec-5126-43cd-a6a1-fdd2878359f5"
],
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"attributes": {},
"status": "ACTIVE",
"createdAt": "May 11, 2020 8:24:06 AM",
"modifiedAt": "May 11, 2020 8:24:06 AM",
"headers": {}
}

JSON sample

{
"ifi": 140827,
"requestId": "b9382c61-c365-4f3d-988e-cffa7b3f886a_4fa18593-d2d9-4bf3-bea7-7f6deb9f2ca4",
"id": "d793ba95-e92d-472b-a44d-75cf7631277c",
"resourceProductId": "2ac114f3",
"resourceProduct": {
"ifi": 140827,
"id": "2ac114f3",
"code": "RPFAM001",
"name": "Prepaid Card Resource Product",
"description": "Prepaid RuPay card resource product for ABC",
"formFactorProducts": [
{
"ifi": 140827,
"id": "4f6ed594",
"code": "CMSFF100",
"name": "ABC Form Factor Pr100",
"description": "Mobile Form Factor Product for ABC",
"type": "phoneNumber",
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"provider": "PMS",
"skuID": "ABC_FAMPAY_MS",
"tags": [],
"attributes": {},
"issuanceStatus": "ACTIVE",
"paymentStatus": "ACTIVE",
"createdAt": "Nov 15, 2019 5:28:13 PM",
"modifiedAt": "Nov 15, 2019 5:28:13 PM",
"headers": {
"tenantID": "140827",
"object": "140827@tenant.zeta.in"
}
},
{
"ifi": 140827,
"id": "66abce21",
"code": "CMSFF001",
"name": "ABC Form Factor Product 001",
"description": "Card Form Factor Product for ABC",
"type": "card",
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"provider": "CMS",
"skuID": "ABC_FAMPAY_MS",
"tags": [],
"attributes": {},
"issuanceStatus": "ACTIVE",
"paymentStatus": "ACTIVE",
"createdAt": "Nov 20, 2019 4:33:37 PM",
"modifiedAt": "Nov 20, 2019 4:33:37 PM",
"headers": {
"tenantID": "140827",
"object": "140827@tenant.zeta.in"
}
}
],
"tags": [],
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"status": "ACTIVE",
"createdAt": "Nov 20, 2019 4:36:45 PM",
"modifiedAt": "Nov 28, 2019 7:20:03 PM",
"headers": {}
},
"targetURI": "account://8780dd20-8171-4849-90e6-8752b2e5b675",
"formFactors": [
{
"id": "7315b748-2ec4-4170-987c-abf337292db6",
"ifi": 140827,
"formFactorProductID": "4f6ed594",
"formFactorID": "+913815141711",
"targetURI": "account:account://8780dd20-8171-4849-90e6-8752b2e5b675",
"tags": [],
"attributes": {},
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"status": "DELETED",
"reason": {
"code": "DAMAGED",
"description": "User card was lost/stolen"
},
"createdAt": "May 11, 2020 8:24:06 AM",
"modifiedAt": "May 11, 2020 8:25:35 AM",
"headers": {}
},
{
"id": "b3121006-f2e1-4d8c-ad64-f7d8086aa0da",
"ifi": 140827,
"formFactorProductID": "66abce21",
"formFactorID": "40323ba2-f091-4d24-bddb-cc5663501bb2",
"targetURI": "account:account://8780dd20-8171-4849-90e6-8752b2e5b675",
"tags": [],
"attributes": {},
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"status": "ACTIVE",
"createdAt": "May 11, 2020 8:24:07 AM",
"modifiedAt": "May 11, 2020 8:24:07 AM",
"headers": {}
}
],
"tags": [],
"vectors": [
"vector://ACCOUNTHOLDER/c99824ec-5126-43cd-a6a1-fdd2878359f5"
],
"policies": {
"issuancePolicies": [],
"paymentPolicies": []
},
"attributes": {},
"status": "ACTIVE",
"createdAt": "May 11, 2020 8:24:06 AM",
"modifiedAt": "May 11, 2020 8:24:06 AM",
"headers": {}
}

On this page

Need Help?

Drop a mail at fusion-support@zeta.tech or call us on 080-6690 5995.

Manage Accounts

Page tree

Get Accounts

Endpoint URI

Request parameters

Example

Get accounts Details

Get accounts by Resource ID

Endpoint URI

Request Parameters

Example

Get accounts by Vector

Endpoint URI

Input Parameters

Example