RFI Examples
Thew following details the different responses you can expect to receive when using the Fetch RFI Template Details request to understand how to respond to Requests for Information (RFIs).
The response you receive when using the Fetch RFI Template Details request details what details you'll need to include in your response to the RFI.
You specifically use the Respond to RFI request and include the details returned in the Fetch RFI Template Details request.
For a list of RFI templates and definitions, see RFI templates.
Please note, both rfiHashId and rfiTemplateId are both currently supported when responding to RFIs. However, rfiTemplateId will be deprecated in the coming months.
We recommend using rfiHashId in in all new implementations. If you have any questions, please contact your Nium account manager or Nium Support.
Applicant details
Templates that appear under applicantDetails includes:
| Template | Description |
|---|---|
applicantAddress | Proof of address for the applicant, such as a utility bill or bank statement. |
applicantIdentity | Government-issued identity document for the applicant. |
applicantAuthorizationLetter | Letter authorizing the applicant to act on behalf of an entity. |
applicantPersonalImage | Recent photo or selfie of the applicant for identity verification. |
applicantreKyc | Data for re-verifying the applicant’s identity, typically via third-party tools. |
Applicant address
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "b93bac45-4661-4217-944a-081bf7b91b2b",
"templateId": "7cddffb5-e076-4965-8433-2e995de7c8f1",
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"template": {
"name": "applicantAddress",
"documentType": "POA",
"type": "document",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Proof of Address Document Type",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Proof of Address Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Require Applicant Adddress Doc for verification (not older than 3 months)",
"status": "RFI_REQUESTED"
}
Respond to RFI request
note
Note: API reference section for Respond to RFI Details mentions businessInfo instead of businessDetails. We accept both values to ensure backward compatibility
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "b93bac45-4661-4217-944a-081bf7b91b2b",
"businessDetails": {
"applicantDetails":{
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"documentDetails":
{
"documentType":"Bank Statement",
"document": [{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "ProofOfAddress.png",
"fileType": "image/png"
}
]
}
}
}
}
]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "7cddffb5-e076-4965-8433-2e995de7c8f1",
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"template": {
"name": "applicantAddress",
"documentType": "POA",
"type": "document",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Proof of Address Document Type",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Proof of Address Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Require Applicant Adddress Doc for verification (not older than 3 months)",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "7cddffb5-e076-4965-8433-2e995de7c8f1",
"businessDetails": {
"applicantDetails":{
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"documentDetails":
{
"documentType":"Bank Statement",
"document": [{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "ProofOfAddress.png",
"fileType": "image/png"
}
]
}
}
}
}
]
}
Applicant identity
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "2a6010c8-2684-4294-bc1f-bc67bb92fceb",
"templateId": "9ef0ddd3-2070-4024-8edd-dcc1b2f2414b",
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"template": {
"name": "applicantIdentity",
"documentType": "POI",
"type": "document",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Identity Document Type",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Identity Document Number",
"fieldValue": "documentNumber",
"type": "data"
},
{
"fieldLabel": "Identity Document Expiry Date",
"fieldValue": "documentExpiryDate",
"type": "data"
},
{
"fieldLabel": "Identity Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Require Applicant Identity Doc for verification",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "2a6010c8-2684-4294-bc1f-bc67bb92fceb",
"businessDetails": {
"applicantDetails":{
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"documentDetails":
{
"documentType":"PASSPORT",
"documentNumber":"123456",
"documentExpiryDate":"2024-11-11",
"documentIssuanceCountry": "UK",
"document": [{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "IdentityProof.png",
"fileType": "image/png"
}
]
}
}
}
}
]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "9ef0ddd3-2070-4024-8edd-dcc1b2f2414b",
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"template": {
"name": "applicantIdentity",
"documentType": "POI",
"type": "document",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Identity Document Type",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Identity Document Number",
"fieldValue": "documentNumber",
"type": "data"
},
{
"fieldLabel": "Identity Document Expiry Date",
"fieldValue": "documentExpiryDate",
"type": "data"
},
{
"fieldLabel": "Identity Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Require Applicant Identity Doc for verification",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "9ef0ddd3-2070-4024-8edd-dcc1b2f2414b",
"businessDetails": {
"applicantDetails":{
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"documentDetails":
{
"documentType":"PASSPORT",
"documentNumber":"123456",
"documentExpiryDate":"2024-11-11",
"documentIssuanceCountry": "UK",
"document": [{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "IdentityProof.png",
"fileType": "image/png"
}
]
}
}
}
}
]
}
Applicant authorization letter
rfiHashId
rfiHashIdFetch RFI Details response
Template for powerOfAttorney is similar to applicantAuthorizationLetter .
{
"rfiHashId": "79b549ec-4f0b-4592-9efd-c8a718973004",
"templateId": "f48ad926-6b3c-4fb8-ba09-36a73c646fe3",
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"template": {
"name": "applicantAuthorizationLetter",
"documentType": "LOA",
"type": "document",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Identity Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Require Letter of Authorisation for Applicant",
"status": "RFI_REQUESTED"
}
Respond to RFI request
Template for powerOfAttorney is similar to applicantAuthorizationLetter .
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "79b549ec-4f0b-4592-9efd-c8a718973004",
"businessDetails": {
"applicantDetails":{
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"documentDetails":
{
"documentType":"LOA",
"document": [{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "LOA.png",
"fileType": "image/png"
}
]
}
}
}
}
]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "f48ad926-6b3c-4fb8-ba09-36a73c646fe3",
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"template": {
"name": "applicantAuthorizationLetter",
"documentType": "LOA",
"type": "document",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Identity Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Require Letter of Authorisation for Applicant",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "f48ad926-6b3c-4fb8-ba09-36a73c646fe3",
"businessDetails": {
"applicantDetails":{
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"documentDetails":
{
"documentType":"LOA",
"document": [{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "LOA.png",
"fileType": "image/png"
}
]
}
}
}
}
]
}
Applicant personal image
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "14f65e1e-449e-40d3-81a6-d2b132f150a2",
"templateId": "fad8ddcf-34a0-4951-a09b-a678bb8a18cc",
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"template": {
"name": "applicantPersonalImage",
"documentType": "POI",
"type": "document",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Selfie Image",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Require latest photograph of the applicant ",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "14f65e1e-449e-40d3-81a6-d2b132f150a2",
"businessDetails": {
"applicantDetails":{
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"documentDetails":
{
"documentType":"Selfie",
"document": [{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "Selfie.png",
"fileType": "image/png"
}
]
}
}
}
}
]
}
rfiTemplateId
rfiTemplateIdFetch Details response
{
"templateId": "fad8ddcf-34a0-4951-a09b-a678bb8a18cc",
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"template": {
"name": "applicantPersonalImage",
"documentType": "POI",
"type": "document",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Selfie Image",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Require latest photograph of the applicant ",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "fad8ddcf-34a0-4951-a09b-a678bb8a18cc",
"businessDetails": {
"applicantDetails":{
"referenceId": "86cc20d6-86d2-4da6-87d1-3d7c1f4cf7b8",
"documentDetails":
{
"documentType":"Selfie",
"document": [{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "Selfie.png",
"fileType": "image/png"
}
]
}
}
}
}
]
}
Applicant reKyc
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "a7b86b3e-809e-4c9b-9ac4-e0a632ade2b8",
"templateId": "758f8e8d-f589-468c-9509-268ce67b3075",
"referenceId": "5ff7c5a9-e7ed-4a7b-a655-0a83eb246e3a",
"template": {
"name": "applicantreKYC",
"type": "data",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Other Data",
"fieldValue": "otherData",
"type": "data"
}
]
},
"remarks": "Please complete the onfido verification: https://integrationspreprod.partners.instarem.com/preprod/compliance/callback/load?referenceNumber=3997dbbf-7f28-4928-9a10-4394b85d5807&token=eyJhQ",
"status": "RFI_REQUESTED"
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "758f8e8d-f589-468c-9509-268ce67b3075",
"referenceId": "5ff7c5a9-e7ed-4a7b-a655-0a83eb246e3a",
"template": {
"name": "applicantreKYC",
"type": "data",
"rfiType": "applicant",
"requiredFields": [
{
"fieldLabel": "Other Data",
"fieldValue": "otherData",
"type": "data"
}
]
},
"remarks": "Please complete the onfido verification: https://integrationspreprod.partners.instarem.com/preprod/compliance/callback/load?referenceNumber=3997dbbf-7f28-4928-9a10-4394b85d5807&token=eyJhQ",
"status": "RFI_REQUESTED"
}
Business details
Templates that appear under businessDetails includes:
| Template |
|---|
businessName |
otherData |
businessRegistrationDocument |
otherDocument |
Business name
rfiHashId
rfiHashIdFetch RFI Details response
{ "rfiHashId": "619691ef-6c2a-4552-8148-9fd978a65143",
"templateId": "ccb58d50-5dad-4bff-a418-3c2d5426e4c2",
"template": {
"name": "businessName",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Business Name",
"fieldValue": "businessName",
"type": "data"
}
]
},
"remarks": "Please submit the name of the business without special charaters",
"status": "RFI_REQUESTED"
},
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "619691ef-6c2a-4552-8148-9fd978a65143",
"businessDetails": {
"businessName":"Bradsons Electronics28 revised"
}
} ]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "ccb58d50-5dad-4bff-a418-3c2d5426e4c2",
"template": {
"name": "businessName",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Business Name",
"fieldValue": "businessName",
"type": "data"
}
]
},
"remarks": "Please submit the name of the business without special charaters",
"status": "RFI_REQUESTED"
},
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "ccb58d50-5dad-4bff-a418-3c2d5426e4c2",
"businessDetails": {
"businessName":"Bradsons Electronics28 revised"
}
} ]
}
Other data
The otherData template is a very useful RFI since agents often use it to fetch any information that doesn't have a template defined. Compliance agent can request multiple otherData templates together with different comments. Make sure to add the right rfiHashId when responding.
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiTemplates": [
{
"rfiHashId": "42261455-0f66-414c-9866-5bfb9281420e",
"templateId": "838c752a-2a3c-42f3-84e9-95a8ab8e9ea2",
"template": {
"name": "otherData",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Other Data",
"fieldValue": "otherData",
"type": "data"
}
]
},
"remarks": "Please provide detailed nature of business",
"status": "RFI_REQUESTED"
},
{
"rfiHashId": "0bb4eead-3166-452d-8aaa-4377e1f69c0c",
"templateId": "838c752a-2a3c-42f3-84e9-95a8ab8e9ea2",
"template": {
"name": "otherData",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Other Data",
"fieldValue": "otherData",
"type": "data"
}
]
},
"remarks": "Clarify if applicant Jake Jacob and stakeholder Jake J Tarter are one and the same.",
"status": "RFI_REQUESTED"
}
]
}
Respond to RFI request
{
"region": "SG",
"clientId": "NIM1693472104978",
"rfiResponseRequest": [
{
"rfiHashId": "42261455-0f66-414c-9866-5bfb9281420e",
"businessDetails": {
"additionalInfo": {
"otherData": "My Detailed Nature of business is to sell Oranges online to customers that are in different countries."
}
}
},
{
"rfiHashId": "0bb4eead-3166-452d-8aaa-4377e1f69c0c",
"businessDetails": {
"additionalInfo": {
"otherData": "Yes they are one and the same, after marriage Jake changed her last name."
}
}
}
]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"rfiTemplates": [
{
"templateId": "838c752a-2a3c-42f3-84e9-95a8ab8e9ea2",
"template": {
"name": "otherData",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Other Data",
"fieldValue": "otherData",
"type": "data"
}
]
},
"remarks": "Please provide detailed nature of business",
"status": "RFI_REQUESTED"
}
]
}
Respond to RFI request
{
"region": "SG",
"clientId": "NIM1693472104978",
"rfiResponseRequest": [
{
"rfiTemplateId": "838c752a-2a3c-42f3-84e9-95a8ab8e9ea2",
"businessDetails": {
"additionalInfo": {
"otherData": "My Detailed Nature of business is to sell Oranges online to customers that are in different countries."
}
}
}
]
}
Business registration document
The following RFIs are similar:
acraasicdirectorsRegisterincorporationForminvoicelicenseotherDocumentpartnershipDeedshareholdersRegistertrustDeeduniqueTaxpayerNumbercorporateAddressProof(Note:documentTypeis an additional value in therequiredFields)
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "0cb888d9-1d3c-4197-b99b-1c8f96a4678f",
"templateId": "cee213af-b9a2-4d35-ae4a-31fdf9ef446b",
"template": {
"name": "businessRegistrationDocument",
"documentType": "document",
"type": "document",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Business Registration Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Please submit the latest Registration Document",
"status": "RFI_REQUESTED"
},{
"rfiHashId": "afcf82d2-e3f1-4031-a115-5530dabcbc59",
"templateId": "76796bf6-ca02-4867-b13f-3661a2594180",
"template": {
"name": "corporateAddressProof",
"documentType": "document",
"type": "document",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Address Proof Document Type for Business",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Address Proof for Business",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Please submit the latest Registration Document",
"status": "RFI_REQUESTED"
}
businessRegistrationDocumentandcorporateAddressProofrequest body for the Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "0cb888d9-1d3c-4197-b99b-1c8f96a4678f",
"businessDetails": {
"documentDetails": {
"documentType": "BUSINESS_REGISTRATION_DOC",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "BRD.png",
"fileType": "image/png"
}
]
}
}
},
{
"rfiHashId": "afcf82d2-e3f1-4031-a115-5530dabcbc59",
"businessDetails": {
"documentDetails": {
"documentType": "Utility Bill",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "utility.png",
"fileType": "image/png"
}
]
}
}
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "cee213af-b9a2-4d35-ae4a-31fdf9ef446b",
"template": {
"name": "businessRegistrationDocument",
"documentType": "document",
"type": "document",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Business Registration Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Please submit the latest Registration Document",
"status": "RFI_REQUESTED"
},{
"templateId": "76796bf6-ca02-4867-b13f-3661a2594180",
"template": {
"name": "corporateAddressProof",
"documentType": "document",
"type": "document",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Address Proof Document Type for Business",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Address Proof for Business",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Please submit the latest Registration Document",
"status": "RFI_REQUESTED"
}
businessRegistrationDocumentandcorporateAddressProofrequest body for the Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "cee213af-b9a2-4d35-ae4a-31fdf9ef446b",
"businessDetails": {
"documentDetails": {
"documentType": "BUSINESS_REGISTRATION_DOC",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "BRD.png",
"fileType": "image/png"
}
]
}
}
},
{
"rfiTemplateId": "76796bf6-ca02-4867-b13f-3661a2594180",
"businessDetails": {
"documentDetails": {
"documentType": "Utility Bill",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "utility.png",
"fileType": "image/png"
}
]
}
}
}
Other document
Compliance agents can request multiple documents in the otherDocument RFI. Make sure to enable uploading of multiple documents for this RFI template and send it in the document field as an array of objects as shown in the example.
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "b93bac45-4661-4217-944a-081bf7b91b2b",
"templateId": "76796bf6-ca02-4867-b13f-3661a2594180",
"template": {
"name": "otherDocument",
"documentType": "document",
"type": "document",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Other Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "1. Please submit taxes filed in 2022 and 2023, 2. Please submit Memorandum of Association.",
"status": "RFI_REQUESTED"
},
{
"rfiHashId": "7df27efd-b5e6-4081-a00c-4b42cb895a79",
"templateId": "76796bf6-ca02-4867-b13f-3661a2594180",
"template": {
"name": "otherDocument",
"documentType": "document",
"type": "document",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Other Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "Please provide No UBO declaration signed by a director.",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"rfiHashId": "b93bac45-4661-4217-944a-081bf7b91b2b",
"businessDetails": {
"documentDetails": {
"documentType": "Utility Bill",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "tax2023.png",
"fileType": "image/png"
},
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "tax2022.png",
"fileType": "image/png"
},
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "memorandum.png",
"fileType": "image/png"
}
]
}
}
},
{
"rfiHashId": "b93bac45-4661-4217-944a-081bf7b91b2b",
"businessDetails": {
"documentDetails": {
"documentType": "UBO Declaration",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "noUBODeclaratn.png",
"fileType": "image/png"
}
}
}
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "76796bf6-ca02-4867-b13f-3661a2594180",
"template": {
"name": "otherDocument",
"documentType": "document",
"type": "document",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Other Document",
"fieldValue": "document",
"type": "document"
}
]
},
"remarks": "1. Please submit taxes filed in 2022 and 2023, 2. Please submit Memorandum of Association.",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"rfiTemplateId": "76796bf6-ca02-4867-b13f-3661a2594180",
"businessDetails": {
"documentDetails": {
"documentType": "Utility Bill",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "tax2023.png",
"fileType": "image/png"
},
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "tax2022.png",
"fileType": "image/png"
},
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "memorandum.png",
"fileType": "image/png"
}
]
}
}
}
Risk assessment
Templates that appear under riskAssessment includes:
| Template in the response of the Fetch RFI Details API |
|---|
| intendedUseOfAccount |
| transactionCountries |
Intended use of account
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "a188dafc-82c7-49fd-a9c7-367b50e61a38",
"templateId": "5c68d9e0-6f23-46f5-86d0-02d6cb81d48b",
"template": {
"name": "intendedUseOfAccount",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Intended Use Of Account",
"fieldValue": "intendedUseOfAccount",
"type": "data"
}
]
},
"remarks": "What do you intend to use this account for?",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "a188dafc-82c7-49fd-a9c7-367b50e61a38",
"riskAssessmentInfo": {
"intendedUseOfAccount": "IU001"
}
}
]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "5c68d9e0-6f23-46f5-86d0-02d6cb81d48b",
"template": {
"name": "intendedUseOfAccount",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Intended Use Of Account",
"fieldValue": "intendedUseOfAccount",
"type": "data"
}
]
},
"remarks": "What do you intend to use this account for?",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "5c68d9e0-6f23-46f5-86d0-02d6cb81d48b",
"riskAssessmentInfo": {
"intendedUseOfAccount": "IU001"
}
}
]
}
Transaction countries
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "9144447e-e63f-4ded-ab17-88c99ed35da2",
"templateId": "177b0715-7b64-45b0-ae7e-1c23c812063a",
"template": {
"name": "transacationCountries",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Payment Corridors",
"fieldValue": "transactionCountries",
"type": "data"
}
]
},
"remarks": "List all the countries you are going to transact",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "9144447e-e63f-4ded-ab17-88c99ed35da2",
"riskAssessmentInfo": {
"transactionCountries": ["US","IN","HK"]
}
}
]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "177b0715-7b64-45b0-ae7e-1c23c812063a",
"template": {
"name": "transacationCountries",
"type": "data",
"rfiType": "corporate",
"requiredFields": [
{
"fieldLabel": "Payment Corridors",
"fieldValue": "transactionCountries",
"type": "data"
}
]
},
"remarks": "List all the countries you are going to transact",
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "177b0715-7b64-45b0-ae7e-1c23c812063a",
"riskAssessmentInfo": {
"transactionCountries": ["US","IN","HK"]
}
}
]
}
Stakeholders
Templates that appear under stakeholders includes:
| Templates |
|---|
| stakeholderAddress |
| stakeholderIdentity |
| stakeholderreKyc |
Stakeholder address
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "1fd4babc-ddd4-4634-bfbc-0444bd74a9da",
"templateId": "4e63476f-a704-461a-865e-253cf905bb60",
"referenceId": "be4e20fd-2a28-4753-b493-dc49f014a473",
"template": {
"name": "stakeholderAddress",
"documentType": "POA",
"type": "document",
"rfiType": "stakeholder",
"requiredFields": [
{
"fieldLabel": "Proof of Address Document Type",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Proof of Address",
"fieldValue": "document",
"type": "document"
}
]
},
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "1fd4babc-ddd4-4634-bfbc-0444bd74a9da",
"businessDetails": {
"stakeholders": [
{
"referenceId": "40262cf7-bda3-4b19-bed3-03cfbb3a2ad3",
"stakeholderDetails": {
"documentDetails": {
"documentType": "Bank Statement",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "STPOA.png",
"fileType": "image/png"
}
]
}
}
}
]
}
} ]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "4e63476f-a704-461a-865e-253cf905bb60",
"referenceId": "be4e20fd-2a28-4753-b493-dc49f014a473",
"template": {
"name": "stakeholderAddress",
"documentType": "POA",
"type": "document",
"rfiType": "stakeholder",
"requiredFields": [
{
"fieldLabel": "Proof of Address Document Type",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Proof of Address",
"fieldValue": "document",
"type": "document"
}
]
},
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "4e63476f-a704-461a-865e-253cf905bb60",
"businessDetails": {
"stakeholders": [
{
"referenceId": "40262cf7-bda3-4b19-bed3-03cfbb3a2ad3",
"stakeholderDetails": {
"documentDetails": {
"documentType": "Bank Statement",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "STPOA.png",
"fileType": "image/png"
}
]
}
}
}
]
}
} ]
}
Stakeholder identity
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "32efd125-4013-49d8-9303-18e04106fdbc",
"templateId": "478b6c22-8fa7-45eb-8498-26e021914121",
"referenceId": "904200f4-b192-40c2-8a46-b4ec1c748b7b",
"remarks":"Need POI for stakeholder"
"template": {
"name": "stakeholderIdentity",
"documentType": "POI",
"type": "document",
"rfiType": "stakeholder",
"requiredFields": [
{
"fieldLabel": "Identity Document Type",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Identity Document Number",
"fieldValue": "documentNumber",
"type": "data"
},
{
"fieldLabel": "Identity Document Expiry Date",
"fieldValue": "documentExpiryDate",
"type": "data"
},
{
"fieldLabel": "Identity Document",
"fieldValue": "document",
"type": "document"
}
]
},
"status": "RFI_REQUESTED"
}
Respond to RFI request
If the referenceId belongs to a corporate stakeholder, use the businessPartner object in place of the stakeholderDetails object. The remaining part of the body is the same.
{
"region": "UK",
"clientId": "NIM1688219482719",
"rfiResponseRequest": [
{
"rfiHashId": "32efd125-4013-49d8-9303-18e04106fdbc",
"businessDetails": {
"stakeholders": [
{
"referenceId": "40262cf7-bda3-4b19-bed3-03cfbb3a2ad3",
"stakeholderDetails": {
"documentDetails": {
"documentType": "PASSPORT",
"documentNumber": "12345678",
"documentExpiryDate": "2024-11-10",
"documentIssuanceCountry":"UK",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "STPOI.png",
"fileType": "image/png"
}
]
}
}
}
]
}
} ]
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "478b6c22-8fa7-45eb-8498-26e021914121",
"referenceId": "904200f4-b192-40c2-8a46-b4ec1c748b7b",
"remarks":"Need POI for stakeholder"
"template": {
"name": "stakeholderIdentity",
"documentType": "POI",
"type": "document",
"rfiType": "stakeholder",
"requiredFields": [
{
"fieldLabel": "Identity Document Type",
"fieldValue": "documentType",
"type": "data"
},
{
"fieldLabel": "Identity Document Number",
"fieldValue": "documentNumber",
"type": "data"
},
{
"fieldLabel": "Identity Document Expiry Date",
"fieldValue": "documentExpiryDate",
"type": "data"
},
{
"fieldLabel": "Identity Document",
"fieldValue": "document",
"type": "document"
}
]
},
"status": "RFI_REQUESTED"
}
Respond to RFI request
{
"region": "UK",
"clientId": "NIM1688219482719",
"caseId": "b8eccc6c-dab2-45ac-9386-ca432e4ae75d",
"rfiResponseRequest": [
{
"rfiTemplateId": "478b6c22-8fa7-45eb-8498-26e021914121",
"businessDetails": {
"stakeholders": [
{
"referenceId": "40262cf7-bda3-4b19-bed3-03cfbb3a2ad3",
"stakeholderDetails": {
"documentDetails": {
"documentType": "PASSPORT",
"documentNumber": "12345678",
"documentExpiryDate": "2024-11-10",
"documentIssuanceCountry":"UK",
"document": [
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "STPOI.png",
"fileType": "image/png"
}
]
}
}
}
]
}
} ]
}
Stakeholder reKyc
rfiHashId
rfiHashIdFetch RFI Details response
{
"rfiHashId": "a7b86b3e-809e-4c9b-9ac4-e0a632ade2b8",
"templateId": "758f8e8d-f589-468c-9509-268ce67b3075",
"referenceId": "5ff7c5a9-e7ed-4a7b-a655-0a83eb246e3a",
"template": {
"name": "stakeholderreKYC",
"type": "data",
"rfiType": "stakeholder",
"requiredFields": [
{
"fieldLabel": "Other Data",
"fieldValue": "otherData",
"type": "data"
}
]
},
"remarks": "Please complete the onfido verification: https://integrationspreprod.partners.instarem.com/preprod/compliance/callback/load?referenceNumber=3997dbbf-7f28-4928-9a10-4394b85d5807&token=eyJhQ",
"status": "RFI_REQUESTED"
}
rfiTemplateId
rfiTemplateIdFetch RFI Details response
{
"templateId": "758f8e8d-f589-468c-9509-268ce67b3075",
"referenceId": "5ff7c5a9-e7ed-4a7b-a655-0a83eb246e3a",
"template": {
"name": "stakeholderreKYC",
"type": "data",
"rfiType": "stakeholder",
"requiredFields": [
{
"fieldLabel": "Other Data",
"fieldValue": "otherData",
"type": "data"
}
]
},
"remarks": "Please complete the onfido verification: https://integrationspreprod.partners.instarem.com/preprod/compliance/callback/load?referenceNumber=3997dbbf-7f28-4928-9a10-4394b85d5807&token=eyJhQ",
"status": "RFI_REQUESTED"
}