aid_management_settings_approvals_payout_destinations_post

Initiate an application for a new seller for Dintero Payout with split-payment. The application will contain a link to an URL where the signatory of the seller will need to finish submission of the case contract and sign it. Dintero will perform a KYC, AML and bank ownership check on the seller before the application case_statuswill be updated to ACTIVE. Once the application is approved, the payout destination will be added automatically to the Dintero Payout service.

scopes:

admin:accounts
write:accounts
write:accounts:/management/settings/approvals

For testing purposes it is possible to auto-approve or decline a new seller by adding one of the following values to payout_destination_description:

"AUTO_APPROVE": Approves the case automatically, the case status will be set to ACTIVE
"AUTO_DECLINE": Declines the case automatically, the case status will be set to DECLINED
"AUTO_WAITING_FOR_SIGNATURE": Leaves the signature check for the case, the case status will be set to WAITING_FOR_SIGNATURE

NOTE: This behavior is only available in test mode, i.e. with an aid prefixed with "T".

aidstring ^[PT]{1}\d{8}$ required

An id that uniquely identifies the account.

Request body

idstring uuid

An UUID that uniquely identifies the resource

created_atstring date-time

The date-time when the resource was created

created_bystring

The ID of the user/client created the resource

updated_atstring date-time

The date-time when the resource was last updated

deleted_bystring

The ID of the user/client created the resource

deleted_atstring date-time

language'en' | 'no'

The language that will be used in emails, declaration form, signing page etc.

payout_destination_idstring required

ID of seller to create when the contract has been completed, signed, and approved.

payout_destination_namestring

The name of the seller

payout_destination_descriptionstring

Description of the seller

payout_referencestring required

A static reference that will be included on bank payments, the name of the service the payout-destination will be enrolled into. Eg. if yor platform is an "Uber for lawnmowers" called "Mowber" the payout_reference should be "Mowber".

type'company' | 'individual'

For a company seller select company or leave blank. Required fields are organization_number and country_code.
For an individual seller select individual. Provide optional fields in the individual object.

country_codestring iso-3166-1

Country code, must be a two letter ISO 3166-1-alpha-2 country code. Required if type is omitted or set to company.

organization_numberstring

National organization number valid in the country specified. Required if type is omitted or set to company.

payout_interval_type'daily' | 'weekly' | 'monthly' | 'manual'

The interval of the payout. The interval can be daily, weekly, monthly or manual.

Example request

{
  "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "deleted_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "individual": {
    "address_line": "Sommerkroveien 34",
    "address_line_2": "PB 123",
    "address_postal_code": "0349",
    "address_city": "Oslo",
    "address_country": "NO"
  },
  "bank_accounts": [
    {
      "bank_account_country_code": "NO",
      "bank_account_currency": "NOK",
      "payout_currency": "NOK",
      "bank_identification_code": "DNBANOKKXXX"
    }
  ]
}

Response

Created ApprovalsPayoutDestinationResponse

idstring uuid

An UUID that uniquely identifies the resource

created_atstring date-time

The date-time when the resource was created

created_bystring

The ID of the user/client created the resource

updated_atstring date-time

The date-time when the resource was last updated

deleted_bystring

The ID of the user/client created the resource

deleted_atstring date-time

language'en' | 'no'

The language that will be used in emails, declaration form, signing page etc.

payout_destination_idstring required

ID of seller to create when the contract has been completed, signed, and approved.

payout_destination_namestring

The name of the seller

payout_destination_descriptionstring

Description of the seller

payout_referencestring required

A static reference that will be included on bank payments, the name of the service the payout-destination will be enrolled into. Eg. if yor platform is an "Uber for lawnmowers" called "Mowber" the payout_reference should be "Mowber".

type'company' | 'individual'

For a company seller select company or leave blank. Required fields are organization_number and country_code.
For an individual seller select individual. Provide optional fields in the individual object.

country_codestring iso-3166-1

Country code, must be a two letter ISO 3166-1-alpha-2 country code. Required if type is omitted or set to company.

organization_numberstring

National organization number valid in the country specified. Required if type is omitted or set to company.

payout_interval_type'daily' | 'weekly' | 'monthly' | 'manual'

The interval of the payout. The interval can be daily, weekly, monthly or manual.

Example response

{
  "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "deleted_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "individual": {
    "address_line": "Sommerkroveien 34",
    "address_line_2": "PB 123",
    "address_postal_code": "0349",
    "address_city": "Oslo",
    "address_country": "NO"
  },
  "bank_accounts": [
    {
      "bank_account_country_code": "NO",
      "bank_account_currency": "NOK",
      "payout_currency": "NOK",
      "bank_identification_code": "DNBANOKKXXX"
    }
  ]
}

v1

aid_management_settings_approvals_payout_destinations_post

Path parameters

Request body

Example request

Response

Example response