v1

latestOpenAPI 3.0.0UNLICENSED2026-07-26178479713.7 KB
approvals

aid_management_settings_approvals_payment_post

Initiate an application for using Dintero payments . The application will contain a link to an URL where the signatory of the account will need to finish submission of the case contract and sign it. Dintero will perform a KYC, AML and bank ownership check before the application case_statuswill be updated to ACTIVE. Once the application is approved we will set up your account for using Dintero payments. Note that not all payment methods are available in all countries, and that for some payments methods some processing time must be expected before you can start accepting payments.

scopes:

  • admin:accounts
  • write:accounts
  • write:accounts:/management/settings/approvals
post/accounts/{aid}/management/settings/approvals/payments

Path parameters

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
country_codestring iso-3166-1 required

Country code, must be a two letter ISO 3166-1-alpha-2 country code

organization_numberstring required

National organization number valid in the country specified.

Example request

{
  "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "deleted_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "bank_accounts": [
    {
      "bank_account_country_code": "NO",
      "bank_account_currency": "NOK",
      "payout_currency": "NOK",
      "bank_identification_code": "DNBANOKKXXX"
    }
  ]
}

Response

Created ApprovalsPaymentResponse

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
country_codestring iso-3166-1 required

Country code, must be a two letter ISO 3166-1-alpha-2 country code

organization_numberstring required

National organization number valid in the country specified.

case_status'ACTIVE' | 'DECLINED' | 'UNDER_MANUAL_REVIEW' | 'AUTOMATIC_REVIEW' | 'WAITING_FOR_SIGNATURE' | 'WAITING_FOR_DECLARATION' | 'ERROR' | 'ARCHIVED' | 'WAITING_FOR_DETAILS' | 'TERMINATED'
mccstring iso-18245

A four-digit Merchant Category Code (MCC) for the store ISO 18245:2003

The MCC set on the case

Example response

{
  "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "deleted_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "bank_accounts": [
    {
      "bank_account_country_code": "NO",
      "bank_account_currency": "NOK",
      "payout_currency": "NOK",
      "bank_identification_code": "DNBANOKKXXX"
    }
  ]
}