Business Trade Finance

Create Trade Finance application

Creates an application for a trade credit line for the business specified in the request URL. Solarisbank will process the application manually. Use the GET endpoint to retrieve information about the application's status.

post/v1/businesses/{business_id}/trade_finance_applications

Path parameters

business_idstring required

ID of the business requesting the trade credit line.

Request body

recipient_ibanstring required

IBAN of the account where the trade loans should be paid out.

partner_scorestring required

An optional scoring value to apply to the Trade Finance application.

partner_reference_numberstring required

Reference identifier at partner

partner_contact_numberstring required

The telephone number of a contact person in your organization.

partner_contact_namestring required

The name of a contact person in your organization.

nominal_interest_ratenumber required

The nominal interest rate to apply to the trade credit line, expressed as a value between 0.0 (i.e., 0%) and 1.0 (i.e., 100%) with up to four decimal places. For example, 0.01 would apply a nominal interest rate of 1% to the trade credit line

identification_idstring required

The ID of the associated business identification

creditreform_scoreinteger required

The creditreform score

creditreform_pdstring required

The creditreform probability of default

application_datestring date required

The date of the application

Example request

{
  "requested_credit_line": {
    "value": 1000,
    "unit": "cents",
    "currency": "EUR"
  },
  "recipient_iban": "DE32110101001000000029",
  "partner_score": "B",
  "partner_reference_number": "3738dbd0-a547-4c11-99e7-770066a39292",
  "partner_contact_number": "+49303003000",
  "partner_contact_name": "Contact Name",
  "nominal_interest_rate": 0.02,
  "identification_id": "e876f41e9b8642bdaaff883ec2f0e144bid",
  "creditreform_score": 150,
  "creditreform_pd": "1.2",
  "application_date": "2019-08-24"
}

Response

The application was successfully created.

status_detailstring

Status details of the application

status'pending' | 'waiting_for_bussiness_identification' | 'cdd_pending' | 'successful_finished' | 'rejected' | 'deleted'

Status of the application

recipient_ibanstring

The IBAN of the recipient's account

partner_scorestring

Partner score

partner_reference_numberstring

Reference identifier at partner

partner_contact_numberstring

Number of the partner contact

partner_contact_namestring

Name of the partner contact

nominal_interest_ratenumber

The nominal interest rate to apply to the trade credit line, expressed as a value between 0.0 (i.e., 0%) and 1.0 (i.e., 100%) with up to four decimal places. For example, 0.01 would apply a nominal interest rate of 1% to the trade credit line.

identification_idstring

The ID of the associated business identification

idstring

The ID of the trade finance application

creditreform_scoreinteger

The creditreform score

creditreform_pdstring

The creditreform probability of default

application_datestring date

The date of the application

Example response

{
  "status": "pending",
  "requested_credit_line": {
    "value": 1000,
    "unit": "cents",
    "currency": "EUR"
  },
  "recipient_iban": "DE92370601930002130041",
  "partner_score": "4",
  "partner_reference_number": "3738dbd0-a547-4c11-99e7-770066a39292",
  "partner_contact_number": "123456789",
  "partner_contact_name": "Contact Name",
  "nominal_interest_rate": 0.02,
  "identification_id": "e876f41e9b8642bdaaff883ec2f0e144bid",
  "id": "55f39e2d78424ac9a9ad5b09adffece2btfa",
  "creditreform_score": 150,
  "creditreform_pd": "1.2",
  "application_date": "2019-08-24"
}