In order to register a financing application, you need some basic information from the financing to create the registration. The minimum information required is:
At least 1 supporting document must accompany the financing details. An FVR can only contain one of a certain document type. An FVR could include between multiple supporting documents, in any combination of:
The document information provided to the API must be in JSON format. The API does not accept PDFs or other binary files. Let’s look at the minimum required fields for an invoice.
Other optional fields are encouraged to be filled out, if available.
Once you have your set of information ready
to submit, we will make a POST
request to the /registrations
end-point. Here is an example of a request body
for an invoice:
{
"pool_identification": "monetago_20220620",
"submitting_financial_institution_identification": "SWHQBEBBXXX",
"batch_collection": [
{
"submitter_batch_identification": "monetago_20220620_1",
"data_set_validation_service": "REGI",
"financing_validation_request_details": [
{
"submitter_data_set_identification": "monetago_20220620_1_1",
"financing_applicant": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"financing_request_amount": {
"currency": "SGD",
"amount": "1,850,600.00"
},
"referred_documents": [
{
"submitter_document_reference": "monetago_20220620_1_1_inv001",
"document_summary": {
"document_type": "CINV",
"issue_date": "2022-05-14",
"seller_identification": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"buyer_identification": {
"name": "Acme Inc",
"country_of_domicile": "US"
},
"invoice_number": "inv001",
"total_invoice_amount": {
"currency": "SGD",
"amount": "1,980,025.15"
}
}
}
]
}
]
}
]
}curl --location --request POST 'https://api.securefinancing.com/v1/registrations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer XYZ' \
--data-raw '{
"pool_identification": "monetago_20220620",
"submitting_financial_institution_identification": "SWHQBEBBXXX",
"batch_collection": [
{
"submitter_batch_identification": "monetago_20220620_1",
"data_set_validation_service": "REGI",
"financing_validation_request_details": [
{
"submitter_data_set_identification": "monetago_20220620_1_1",
"financing_applicant": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"financing_request_amount": {
"currency": "SGD",
"amount": "1,850,600.00"
},
"referred_documents": [
{
"submitter_document_reference": "monetago_20220620_1_1_inv001",
"document_summary": {
"document_type": "CINV",
"issue_date": "2022-05-14",
"seller_identification": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"buyer_identification": {
"name": "Acme Inc",
"country_of_domicile": "US"
},
"invoice_number": "inv001",
"total_invoice_amount": {
"currency": "SGD",
"amount": "1,980,025.15"
}
}
}
]
}
]
}
]
}'var request = require("request");
var options = {
method: "POST",
url: "https://api.securefinancing.com/v1/registrations",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer XYZ",
},
body: JSON.stringify({
pool_identification: "monetago_20220620",
submitting_financial_institution_identification: "SWHQBEBBXXX",
batch_collection: [
{
submitter_batch_identification: "monetago_20220620_1",
data_set_validation_service: "REGI",
financing_validation_request_details: [
{
submitter_data_set_identification: "monetago_20220620_1_1",
financing_applicant: {
name: "MonetaGo Asia Pacific Private Limited",
country_of_domicile: "SG",
},
financing_request_amount: {
currency: "SGD",
amount: "1,850,600.00",
},
referred_documents: [
{
submitter_document_reference: "monetago_20220620_1_1_inv001",
document_summary: {
document_type: "CINV",
issue_date: "2022-05-14",
seller_identification: {
name: "MonetaGo Asia Pacific Private Limited",
country_of_domicile: "SG",
},
buyer_identification: {
name: "Acme Inc",
country_of_domicile: "US",
},
invoice_number: "inv001",
total_invoice_amount: {
currency: "SGD",
amount: "1,980,025.15",
},
},
},
],
},
],
},
],
}),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});import requests
import json
url = "https://api.securefinancing.com/v1/registrations"
payload = json.dumps({
"pool_identification": "monetago_20220620",
"submitting_financial_institution_identification": "SWHQBEBBXXX",
"batch_collection": [
{
"submitter_batch_identification": "monetago_20220620_1",
"data_set_validation_service": "REGI",
"financing_validation_request_details": [
{
"submitter_data_set_identification": "monetago_20220620_1_1",
"financing_applicant": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"financing_request_amount": {
"currency": "SGD",
"amount": "1,850,600.00"
},
"referred_documents": [
{
"submitter_document_reference": "monetago_20220620_1_1_inv001",
"document_summary": {
"document_type": "CINV",
"issue_date": "2022-05-14",
"seller_identification": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"buyer_identification": {
"name": "Acme Inc",
"country_of_domicile": "US"
},
"invoice_number": "inv001",
"total_invoice_amount": {
"currency": "SGD",
"amount": "1,980,025.15"
}
}
}
]
}
]
}
]
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer XYZ'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n \"pool_identification\": \"monetago_20220620\",\n \"submitting_financial_institution_identification\": \"SWHQBEBBXXX\",\n \"batch_collection\": [\n {\n \"submitter_batch_identification\": \"monetago_20220620_1\",\n \"data_set_validation_service\": \"REGI\",\n \"financing_validation_request_details\": [\n {\n \"submitter_data_set_identification\": \"monetago_20220620_1_1\",\n \"financing_applicant\": {\n \"name\": \"MonetaGo Asia Pacific Private Limited\",\n \"country_of_domicile\": \"SG\"\n },\n \"financing_request_amount\": {\n \"currency\": \"SGD\",\n \"amount\": \"1,850,600.00\"\n },\n \"referred_documents\": [\n {\n \"submitter_document_reference\": \"monetago_20220620_1_1_inv001\",\n \"document_summary\": {\n \"document_type\": \"CINV\",\n \"issue_date\": \"2022-05-14\",\n \"seller_identification\": {\n \"name\": \"MonetaGo Asia Pacific Private Limited\",\n \"country_of_domicile\": \"SG\"\n },\n \"buyer_identification\": {\n \"name\": \"Acme Inc\",\n \"country_of_domicile\": \"US\"\n },\n \"invoice_number\": \"inv001\",\n \"total_invoice_amount\": {\n \"currency\": \"SGD\",\n \"amount\": \"1,980,025.15\"\n }\n }\n }\n ]\n }\n ]\n }\n ]\n}");
Request request = new Request.Builder()
.url("https://api.securefinancing.com/v1/registrations")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.addHeader("Authorization", "Bearer XYZ")
.build();
Response response = client.newCall(request).execute();After submitting your request you should
receive a 201 success response
containing a request identifier.
201
{ "request_identification": "123e4567-e89b-42d3-a456-426614174000" }
Just replace the token in the Authorization header with your own, and click send. (This is a customer test environment and will not impact the live system)
{
"method": "post",
"url": "https://api.uat.securefinancing.com/v1/registrations",
"headers":
{ "Authorization": "Bearer token", "Content-Type": "application/json" },
"body":
{
"pool_identification": "monetago_20220620",
"submitting_financial_institution_identification": "SWHQBEBBXXX",
"batch_collection":
[
{
"submitter_batch_identification": "monetago_20220620_1",
"data_set_validation_service": "REGI",
"financing_validation_request_details":
[
{
"submitter_data_set_identification": "monetago_20220620_1_1",
"financing_applicant":
{
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG",
},
"financing_request_amount":
{ "currency": "SGD", "amount": "1,850,600.00" },
"referred_documents":
[
{
"submitter_document_reference": "monetago_20220620_1_1_inv001",
"document_summary":
{
"document_type": "CINV",
"issue_date": "2022-05-14",
"seller_identification":
{
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG",
},
"buyer_identification":
{
"name": "Acme Inc",
"country_of_domicile": "US",
},
"invoice_number": "inv001",
"total_invoice_amount":
{ "currency": "SGD", "amount": "1,980,025.15" },
},
},
],
},
],
},
],
},
}The /registrations end-point
supports batches of financings in a single
request. It actually even supports multiple
batches per single request. This is because a
batch can have business significance in the case
of securitized or portfolio lending, where many
transactions are being financed together as a
single unit. We can leverage the batch to define
special behavior in such cases. Commonly, it is
required that for a securitized batch of assets,
if any individual asset should be identified as
a duplicate or high risk, the entire batch
should not be progressed to the ‘Financed’ state
(also referred to as ‘All-or-None’ logic). So we
can submit multiple batches in a single request,
each with its own defined behavior in the case
of duplicates being identified.
This special behavior is optional and we can
also use batches to facilitate a streamlined
submission in a single request where financings
within a batch are not related to each other in
any way. We use the batch_booking
flag to denote whether the batch is securitized
as a single unit or not.
The collection of financings that live within the “financing_validation_request_details” array field are considered an individual batch. And you can have multiple such batches listed in the higher level “batches” array field.
Here is an example of a single batch request containing 2 financings, registered as a securitized unit:
{
"pool_identification": "monetago_20220620",
"submitting_financial_institution_identification": "SWHQBEBBXXX",
"batch_collection": [
{
"submitter_batch_identification": "monetago_20220620_1",
"data_set_validation_service": "REGI",
"financing_validation_request_details": [
{
"submitter_data_set_identification": "monetago_20220620_1_1",
"financing_applicant": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"financing_request_amount": {
"currency": "SGD",
"amount": "1,850,600.00"
},
"referred_documents": [
{
"submitter_document_reference": "monetago_20220620_1_1_inv001",
"document_summary": {
"document_type": "CINV",
"issue_date": "2022-05-14",
"seller_identification": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"buyer_identification": {
"name": "Acme Inc",
"country_of_domicile": "US"
},
"invoice_number": "inv001",
"total_invoice_amount": {
"currency": "SGD",
"amount": "1,980,025.15"
}
}
}
]
},
{
"submitter_data_set_identification": "monetago_20220620_1_2",
"financing_applicant": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"financing_request_amount": {
"currency": "SGD",
"amount": "1,050,000.00"
},
"referred_documents": [
{
"submitter_document_reference": "monetago_20220620_1_2_inv002",
"document_summary": {
"document_type": "CINV",
"issue_date": "2022-05-15",
"seller_identification": {
"name": "MonetaGo Asia Pacific Private Limited",
"country_of_domicile": "SG"
},
"buyer_identification": {
"name": "Big Manufacturing Company Inc",
"country_of_domicile": "US"
},
"invoice_number": "inv002",
"total_invoice_amount": {
"currency": "SGD",
"amount": "1,103,245.23"
}
}
}
]
}
]
}
]
}Warning
When dealing with securitized batches, you still need to provide financing amounts against individual assets, and not the whole batch. We recommend you pro-rate the total batch financing amount across the individual financings based on the individual asset values (e.g. invoice amount)
A pool is an optional, convenience measure to cluster requests for reference. A pool can contain one or multiple FVRs, one or multiple batches, or a combination of both. There is no limit on the number of batches or FVRs that can be registered within a pool. A Pool ID, a character string of maximum 35 characters, can be created by the user and can be used to reference or execute bulk actions on the pool.
An option is provided to streamline the
registration and financing steps into a single
request. This may be used when a lender wishes
to progress previously un-registered financings
directly to the ‘Financed’ state as they have
already made the internal decision to approve
the financing. The duplicate check is then used
post-decision as a final validation prior to
disbursing the loan funds to the applicant. The
data_set_validation_service code
will determine whether the financings are just
registered, or both registered and immediately
financed.
There are two registration options within the
“data_set_validation_service” - “REGI”
(register) and “REFI” (register and finance).
“REGI” will only register the FVRs within the
request. “REFI” will both register AND finance
the FVRs within the request. “REFI” will not
finance FVRs that are in the “DFIN” (duplicate
financed) state, nor will “REFI” finance any of
the FVRs within a batch that has
“batch_booking”=TRUE if a “DFIN” FVR is present
within the batch. If you use
"data_set_validation_service": "REFI",
you do not need to subsequently call the
/financings end-point for that
batch. Unless they have exact duplicate matches,
they will go straight to the ‘Financed’
state.