mirror of https://github.com/hanzo-fi/payments.git synced 2026-10-30 20:31:20 +00:00

Files

T

fgueryandGitHub 58271b3544 feat(CONN-92): qonto connector (#427 )

* doc(conn-92): fix doc link

* doc(CONN-92): clarify the new connector creation instructions

* feat(CONN-92): qonto plugin, account retrieval

* feat(CONN-92): implement pagination and fix timezone

* feat(CONN-92): add metadata

* feat(CONN-92): fetchBalance implemented

* feat(CONN-92): remove unsupported capabilities

* feat(CONN-92): bank account type differ from different endpoint

* feat(CONN-92): added external account + beneficiaries endpoint

* feat(CONN-92): invalid beneficiary's accounts actually happen all the time

* feat(CONN-92): allow multiple currencies for external accounts

* feat(CONN-92): temp commit to debug payment save

* feat(CONN-92): remove loggers

* feat(CONN-92): better job at omitempty

* feat(CONN-92): fix payment destination account to match external account

* feat(CONN-92): added test for no from payload

* feat(CONN-92): test on raw where relevant

* feat(CONN-92): added payment_test

* feat(CONN-92): use jsonNumber for incoming floats

* feat(CONN_92): remove page number from request, instead use last_updated + pagesize

* feat(CONN-92): fetch all transactions by statuses, in order (not only completed ones)

* feat(CONN-92): always add the parentReference

* feat(CONN-92): extract couple of method to improve readability

* feat(CONN-92): use constants for transaction status

* feat(CONN-92): added comment on transaction status

* feat(CONN-92): add transfer endpoint

* feat(CONN-92): unify account metadata syntax between internal & external accounts

* feat(CONN-92): make plugin inherit from basePlugin

* feat(CONN-92): add transfer capability

* feat(CONN-92): fix internal transfert -- doc is lying on the response format

* feat(CONN-92): avoid sending update_at_from == zero time (as Qonto refuses the request)

* feat(CONN-92): coderabbit suggestions:

* fix error formatting
* more leniency in transfer response status check (allwing completed)
* more validaiton when creating a transfer

* feat(CONN-92): more coderabbit suggestions, improve error reporting

* feat(CONN-92): more coderabbit suggestions, more errors on invalid state

* feat(CONN-92): more coderabbit reviews, more coverage and bits of refacto

* feat(CONN-92): bit more coverage

* feat(CONN-92): bit more coverage

* feat(CONN-92): added more coverage for config & errors; also improved Qonto's error reporting

* feat(CONN-92): precommit run

* feat(CONN-92): remove needMore functionality as its mostly irrelevant here

* feat(CONN-92): codeRabbit is right, Qonto has a max page size -- my bad

* feat(CONN-92): correct Account pagination

* feat(CONN-92): account pagination with equal lastUpdatedAt

* feat(CONN-92): review pagination for beneficiaries and payments

* feat(CONN-92): update speakeasy lock

* feat(CONN-92): added a bit of comments on the surprising bits

* feat(CONN-92): codeRabbit comment

* feat(CONN-92): transfer don't always return currency -- we can default to EUR as its the only one supported

* feat(CONN-92): return error when account does not have currency set

* feat(CONN-92): remove initialization of lastUpdatedAt

* feat(CONN-92): remove all pagination from accounts, as we fetch all anyway

* feat(CONN-92): cleaned somewhat the http connection logic

* feat(CONN-92): add uuid in transfer as reference to pick it up for transaction matching later on

* feat(CONN-92): detect transactions created via transfer and set parentId appropriately

* feat(CONN-92): truncate too long reference

* feat(CONN-92): remove create internal transfer endpoint

2025-05-20 13:59:57 +00:00

147 KiB

Raw Permalink Blame History

Payments API v1

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

payments.v1

Get server info

Code samples

GET /_info HTTP/1.1

Accept: application/json

GET /_info

Example responses

Responses

Status	Meaning	Description	Schema
200	OK	Server information	None
default	Default	none	None

Response Schema

payments.v3

Create a formance account object. This object will not be forwarded to the connector. It is only used for internal purposes.

Code samples

POST /v3/accounts HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/accounts

Body parameter

{
  "reference": "string",
  "connectorID": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "accountName": "string",
  "type": "UNKNOWN",
  "defaultAsset": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Parameters

Name	In	Type	Required	Description
body	body	V3CreateAccountRequest	false	none

Example responses

201 Response

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "type": "UNKNOWN",
    "name": "string",
    "defaultAsset": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "raw": {}
  }
}

Responses

Status	Meaning	Description	Schema
201	Created	Created	V3CreateAccountResponse
default	Default	Error	V3ErrorResponse

List all accounts

Code samples

GET /v3/accounts HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/accounts

Body parameter

{}

Parameters

Name	In	Type	Required	Description
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

cursor: Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "provider": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "type": "UNKNOWN",
        "name": "string",
        "defaultAsset": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "raw": {}
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3AccountsCursorResponse
default	Default	Error	V3ErrorResponse

Get an account by ID

Code samples

GET /v3/accounts/{accountID} HTTP/1.1

Accept: application/json

GET /v3/accounts/{accountID}

Parameters

Name	In	Type	Required	Description
accountID	path	string	true	The account ID

Example responses

200 Response

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "type": "UNKNOWN",
    "name": "string",
    "defaultAsset": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "raw": {}
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3GetAccountResponse
default	Default	Error	V3ErrorResponse

Get account balances

Code samples

GET /v3/accounts/{accountID}/balances HTTP/1.1

Accept: application/json

GET /v3/accounts/{accountID}/balances

Parameters

Name	In	Type	Required	Description
accountID	path	string	true	The account ID
asset	query	string	false	The asset to filter by
fromTimestamp	query	string(date-time)	false	The start of the time range to filter by
toTimestamp	query	string(date-time)	false	The end of the time range to filter by
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "accountID": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "lastUpdatedAt": "2019-08-24T14:15:22Z",
        "asset": "string",
        "balance": 0
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3BalancesCursorResponse
default	Default	Error	V3ErrorResponse

Create a formance bank account object. This object will not be forwarded to the connector until you called the forwardBankAccount method.

Code samples

POST /v3/bank-accounts HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/bank-accounts

Body parameter

{
  "name": "string",
  "accountNumber": "string",
  "iban": "string",
  "swiftBicCode": "string",
  "country": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Parameters

Name	In	Type	Required	Description
body	body	V3CreateBankAccountRequest	false	none

Example responses

201 Response

{
  "data": "string"
}

Responses

Status	Meaning	Description	Schema
201	Created	Created	V3CreateBankAccountResponse
default	Default	Error	V3ErrorResponse

List all bank accounts

Code samples

GET /v3/bank-accounts HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/bank-accounts

Body parameter

{}

Parameters

Name	In	Type	Required	Description
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "accountNumber": "string",
        "iban": "string",
        "swiftBicCode": "string",
        "country": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "relatedAccounts": [
          {
            "accountID": "string",
            "createdAt": "2019-08-24T14:15:22Z"
          }
        ]
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3BankAccountsCursorResponse
default	Default	Error	V3ErrorResponse

Get a Bank Account by ID

Code samples

GET /v3/bank-accounts/{bankAccountID} HTTP/1.1

Accept: application/json

GET /v3/bank-accounts/{bankAccountID}

Parameters

Name	In	Type	Required	Description
bankAccountID	path	string	true	The bank account ID

Example responses

200 Response

{
  "data": {
    "id": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "name": "string",
    "accountNumber": "string",
    "iban": "string",
    "swiftBicCode": "string",
    "country": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "relatedAccounts": [
      {
        "accountID": "string",
        "createdAt": "2019-08-24T14:15:22Z"
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3GetBankAccountResponse
default	Default	Error	V3ErrorResponse

Update a bank account's metadata

Code samples

PATCH /v3/bank-accounts/{bankAccountID}/metadata HTTP/1.1

Content-Type: application/json
Accept: application/json

PATCH /v3/bank-accounts/{bankAccountID}/metadata

Body parameter

{
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Parameters

Name	In	Type	Required	Description
bankAccountID	path	string	true	The bank account ID
body	body	V3UpdateBankAccountMetadataRequest	false	none

Example responses

default Response

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	No Content	None
default	Default	Error	V3ErrorResponse

Forward a Bank Account to a PSP for creation

Code samples

POST /v3/bank-accounts/{bankAccountID}/forward HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/bank-accounts/{bankAccountID}/forward

Body parameter

{
  "connectorID": "string"
}

Parameters

Name	In	Type	Required	Description
bankAccountID	path	string	true	The bank account ID
body	body	V3ForwardBankAccountRequest	false	none

Example responses

202 Response

{
  "data": {
    "taskID": "string"
  }
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3ForwardBankAccountResponse
default	Default	Error	V3ErrorResponse

List all connectors

Code samples

GET /v3/connectors HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/connectors

Body parameter

{}

Parameters

Name	In	Type	Required	Description
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "reference": "string",
        "name": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "provider": "string",
        "scheduledForDeletion": true,
        "config": {}
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3ConnectorsCursorResponse
default	Default	Error	V3ErrorResponse

Install a connector

Code samples

POST /v3/connectors/install/{connector} HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/connectors/install/{connector}

Body parameter

{
  "apiKey": "string",
  "companyID": "string",
  "liveEndpointPrefix": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Adyen",
  "webhookPassword": "string",
  "webhookUsername": "string"
}

Parameters

Name	In	Type	Required	Description
connector	path	string	true	The connector to filter by
body	body	V3ConnectorConfig	false	none

Example responses

202 Response

{
  "data": "string"
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3InstallConnectorResponse
default	Default	Error	V3ErrorResponse

List all connector configurations

Code samples

GET /v3/connectors/configs HTTP/1.1

Accept: application/json

GET /v3/connectors/configs

Example responses

200 Response

{
  "data": {
    "property1": {
      "property1": {
        "dataType": "string",
        "required": true,
        "defaultValue": "string"
      },
      "property2": {
        "dataType": "string",
        "required": true,
        "defaultValue": "string"
      }
    },
    "property2": {
      "property1": {
        "dataType": "string",
        "required": true,
        "defaultValue": "string"
      },
      "property2": {
        "dataType": "string",
        "required": true,
        "defaultValue": "string"
      }
    }
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3ConnectorConfigsResponse
default	Default	Error	V3ErrorResponse

Uninstall a connector

Code samples

DELETE /v3/connectors/{connectorID} HTTP/1.1

Accept: application/json

DELETE /v3/connectors/{connectorID}

Parameters

Name	In	Type	Required	Description
connectorID	path	string	true	The connector ID

Example responses

202 Response

{
  "data": {
    "taskID": "string"
  }
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3UninstallConnectorResponse
default	Default	Error	V3ErrorResponse

Get a connector configuration by ID

Code samples

GET /v3/connectors/{connectorID}/config HTTP/1.1

Accept: application/json

GET /v3/connectors/{connectorID}/config

Parameters

Name	In	Type	Required	Description
connectorID	path	string	true	The connector ID

Example responses

200 Response

{
  "data": {
    "apiKey": "string",
    "companyID": "string",
    "liveEndpointPrefix": "string",
    "name": "string",
    "pageSize": "25",
    "pollingPeriod": "2m",
    "provider": "Adyen",
    "webhookPassword": "string",
    "webhookUsername": "string"
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3GetConnectorConfigResponse
default	Default	Error	V3ErrorResponse

Update the config of a connector

Code samples

PATCH /v3/connectors/{connectorID}/config HTTP/1.1

Content-Type: application/json

PATCH /v3/connectors/{connectorID}/config

Update connector config

Body parameter

{
  "apiKey": "string",
  "companyID": "string",
  "liveEndpointPrefix": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Adyen",
  "webhookPassword": "string",
  "webhookUsername": "string"
}

Parameters

Name	In	Type	Required	Description
connectorID	path	string	true	The connector ID
body	body	V3ConnectorConfig	false	none

Responses

Status	Meaning	Description	Schema
204	No Content	none	None
default	Default	none	None

Reset a connector. Be aware that this will delete all data and stop all existing tasks like payment initiations and bank account creations.

Code samples

POST /v3/connectors/{connectorID}/reset HTTP/1.1

Accept: application/json

POST /v3/connectors/{connectorID}/reset

Parameters

Name	In	Type	Required	Description
connectorID	path	string	true	The connector ID

Example responses

202 Response

{
  "data": "string"
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3ResetConnectorResponse
default	Default	Error	V3ErrorResponse

List all connector schedules

Code samples

GET /v3/connectors/{connectorID}/schedules HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/connectors/{connectorID}/schedules

Body parameter

{}

Parameters

Name	In	Type	Required	Description
connectorID	path	string	true	The connector ID
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "createdAt": "2019-08-24T14:15:22Z"
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3ConnectorSchedulesCursorResponse
default	Default	Error	V3ErrorResponse

Get a connector schedule by ID

Code samples

GET /v3/connectors/{connectorID}/schedules/{scheduleID} HTTP/1.1

Accept: application/json

GET /v3/connectors/{connectorID}/schedules/{scheduleID}

Parameters

Name	In	Type	Required	Description
connectorID	path	string	true	The connector ID
scheduleID	path	string	true	The schedule ID

Example responses

200 Response

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "createdAt": "2019-08-24T14:15:22Z"
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3ConnectorScheduleResponse
default	Default	Error	V3ErrorResponse

List all connector schedule instances

Code samples

GET /v3/connectors/{connectorID}/schedules/{scheduleID}/instances HTTP/1.1

Accept: application/json

GET /v3/connectors/{connectorID}/schedules/{scheduleID}/instances

Parameters

Name	In	Type	Required	Description
connectorID	path	string	true	The connector ID
scheduleID	path	string	true	The schedule ID
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "scheduleID": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "terminated": true,
        "terminatedAt": "2019-08-24T14:15:22Z",
        "error": "string"
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3ConnectorScheduleInstancesCursorResponse
default	Default	Error	V3ErrorResponse

Create a formance payment object. This object will not be forwarded to the connector. It is only used for internal purposes.

Code samples

POST /v3/payments HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/payments

Body parameter

{
  "reference": "string",
  "connectorID": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "type": "UNKNOWN",
  "initialAmount": 0,
  "amount": 0,
  "asset": "string",
  "scheme": "string",
  "sourceAccountID": "string",
  "destinationAccountID": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "adjustments": [
    {
      "reference": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "status": "UNKNOWN",
      "amount": 0,
      "asset": "string",
      "metadata": {
        "property1": "string",
        "property2": "string"
      }
    }
  ]
}

Parameters

Name	In	Type	Required	Description
body	body	V3CreatePaymentRequest	false	none

Example responses

201 Response

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "type": "UNKNOWN",
    "initialAmount": 0,
    "amount": 0,
    "asset": "string",
    "scheme": "string",
    "status": "UNKNOWN",
    "sourceAccountID": "string",
    "destinationAccountID": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "adjustments": [
      {
        "id": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "status": "UNKNOWN",
        "amount": 0,
        "asset": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "raw": {}
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
201	Created	Created	V3CreatePaymentResponse
default	Default	Error	V3ErrorResponse

List all payments

Code samples

GET /v3/payments HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/payments

Body parameter

{}

Parameters

Name	In	Type	Required	Description
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "provider": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "type": "UNKNOWN",
        "initialAmount": 0,
        "amount": 0,
        "asset": "string",
        "scheme": "string",
        "status": "UNKNOWN",
        "sourceAccountID": "string",
        "destinationAccountID": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "adjustments": [
          {
            "id": "string",
            "reference": "string",
            "createdAt": "2019-08-24T14:15:22Z",
            "status": "UNKNOWN",
            "amount": 0,
            "asset": "string",
            "metadata": {
              "property1": "string",
              "property2": "string"
            },
            "raw": {}
          }
        ]
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3PaymentsCursorResponse
default	Default	Error	V3ErrorResponse

Get a payment by ID

Code samples

GET /v3/payments/{paymentID} HTTP/1.1

Accept: application/json

GET /v3/payments/{paymentID}

Parameters

Name	In	Type	Required	Description
paymentID	path	string	true	The payment ID

Example responses

200 Response

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "type": "UNKNOWN",
    "initialAmount": 0,
    "amount": 0,
    "asset": "string",
    "scheme": "string",
    "status": "UNKNOWN",
    "sourceAccountID": "string",
    "destinationAccountID": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "adjustments": [
      {
        "id": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "status": "UNKNOWN",
        "amount": 0,
        "asset": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "raw": {}
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3GetPaymentResponse
default	Default	Error	V3ErrorResponse

Update a payment's metadata

Code samples

PATCH /v3/payments/{paymentID}/metadata HTTP/1.1

Content-Type: application/json
Accept: application/json

PATCH /v3/payments/{paymentID}/metadata

Body parameter

{
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Parameters

Name	In	Type	Required	Description
paymentID	path	string	true	The payment ID
body	body	V3UpdatePaymentMetadataRequest	false	none

Example responses

default Response

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	No Content	None
default	Default	Error	V3ErrorResponse

Initiate a payment

Code samples

POST /v3/payment-initiations HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/payment-initiations

Body parameter

{
  "reference": "string",
  "scheduledAt": "2019-08-24T14:15:22Z",
  "connectorID": "string",
  "description": "string",
  "type": "UNKNOWN",
  "amount": 0,
  "asset": "string",
  "sourceAccountID": "string",
  "destinationAccountID": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Parameters

Name	In	Type	Required	Description
noValidation	query	boolean	false	If set to true, the request will not have to be validated. This is useful if we want to directly forward the request to the PSP.
body	body	V3InitiatePaymentRequest	false	none

Detailed descriptions

noValidation: If set to true, the request will not have to be validated. This is useful if we want to directly forward the request to the PSP.

Example responses

202 Response

{
  "data": {
    "paymentInitiationID": "string",
    "taskID": "string"
  }
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3InitiatePaymentResponse
default	Default	Error	V3ErrorResponse

List all payment initiations

Code samples

GET /v3/payment-initiations HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/payment-initiations

Body parameter

{}

Parameters

Name	In	Type	Required	Description
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "provider": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "scheduledAt": "2019-08-24T14:15:22Z",
        "description": "string",
        "type": "UNKNOWN",
        "amount": 0,
        "asset": "string",
        "status": "UNKNOWN",
        "sourceAccountID": "string",
        "destinationAccountID": "string",
        "error": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        }
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3PaymentInitiationsCursorResponse
default	Default	Error	V3ErrorResponse

Delete a payment initiation by ID

Code samples

DELETE /v3/payment-initiations/{paymentInitiationID} HTTP/1.1

Accept: application/json

DELETE /v3/payment-initiations/{paymentInitiationID}

Parameters

Name	In	Type	Required	Description
paymentInitiationID	path	string	true	The payment initiation ID

Example responses

default Response

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	No Content	None
default	Default	Error	V3ErrorResponse

Get a payment initiation by ID

Code samples

GET /v3/payment-initiations/{paymentInitiationID} HTTP/1.1

Accept: application/json

GET /v3/payment-initiations/{paymentInitiationID}

Parameters

Name	In	Type	Required	Description
paymentInitiationID	path	string	true	The payment initiation ID

Example responses

200 Response

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "scheduledAt": "2019-08-24T14:15:22Z",
    "description": "string",
    "type": "UNKNOWN",
    "amount": 0,
    "asset": "string",
    "status": "UNKNOWN",
    "sourceAccountID": "string",
    "destinationAccountID": "string",
    "error": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    }
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3GetPaymentInitiationResponse
default	Default	Error	V3ErrorResponse

Retry a payment initiation

Code samples

POST /v3/payment-initiations/{paymentInitiationID}/retry HTTP/1.1

Accept: application/json

POST /v3/payment-initiations/{paymentInitiationID}/retry

Parameters

Name	In	Type	Required	Description
paymentInitiationID	path	string	true	The payment initiation ID

Example responses

202 Response

{
  "data": {
    "taskID": "string"
  }
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3RetryPaymentInitiationResponse
default	Default	Error	V3ErrorResponse

Approve a payment initiation

Code samples

POST /v3/payment-initiations/{paymentInitiationID}/approve HTTP/1.1

Accept: application/json

POST /v3/payment-initiations/{paymentInitiationID}/approve

Parameters

Name	In	Type	Required	Description
paymentInitiationID	path	string	true	The payment initiation ID

Example responses

202 Response

{
  "data": {
    "taskID": "string"
  }
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3ApprovePaymentInitiationResponse
default	Default	Error	V3ErrorResponse

Reject a payment initiation

Code samples

POST /v3/payment-initiations/{paymentInitiationID}/reject HTTP/1.1

Accept: application/json

POST /v3/payment-initiations/{paymentInitiationID}/reject

Parameters

Name	In	Type	Required	Description
paymentInitiationID	path	string	true	The payment initiation ID

Example responses

default Response

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	No Content	None
default	Default	Error	V3ErrorResponse

Reverse a payment initiation

Code samples

POST /v3/payment-initiations/{paymentInitiationID}/reverse HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/payment-initiations/{paymentInitiationID}/reverse

Body parameter

{
  "reference": "string",
  "description": "string",
  "amount": 0,
  "asset": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Parameters

Name	In	Type	Required	Description
paymentInitiationID	path	string	true	The payment initiation ID
body	body	V3ReversePaymentInitiationRequest	false	none

Example responses

202 Response

{
  "data": {
    "taskID": "string",
    "paymentInitiationReversalID": "string"
  }
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3ReversePaymentInitiationResponse
default	Default	Error	V3ErrorResponse

List all payment initiation adjustments

Code samples

GET /v3/payment-initiations/{paymentInitiationID}/adjustments HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/payment-initiations/{paymentInitiationID}/adjustments

Body parameter

{}

Parameters

Name	In	Type	Required	Description
paymentInitiationID	path	string	true	The payment initiation ID
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "status": "UNKNOWN",
        "amount": 0,
        "asset": "string",
        "error": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        }
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3PaymentInitiationAdjustmentsCursorResponse
default	Default	Error	V3ErrorResponse

Code samples

GET /v3/payment-initiations/{paymentInitiationID}/payments HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/payment-initiations/{paymentInitiationID}/payments

Body parameter

{}

Name	In	Type	Required	Description
paymentInitiationID	path	string	true	The payment initiation ID
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "provider": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "type": "UNKNOWN",
        "initialAmount": 0,
        "amount": 0,
        "asset": "string",
        "scheme": "string",
        "status": "UNKNOWN",
        "sourceAccountID": "string",
        "destinationAccountID": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "adjustments": [
          {
            "id": "string",
            "reference": "string",
            "createdAt": "2019-08-24T14:15:22Z",
            "status": "UNKNOWN",
            "amount": 0,
            "asset": "string",
            "metadata": {
              "property1": "string",
              "property2": "string"
            },
            "raw": {}
          }
        ]
      }
    ]
  }
}

Status	Meaning	Description	Schema
200	OK	OK	V3PaymentInitiationRelatedPaymentsCursorResponse
default	Default	Error	V3ErrorResponse

Create a formance payment service user object

Code samples

POST /v3/payment-service-users HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/payment-service-users

Body parameter

{
  "name": "string",
  "contactDetails": {
    "email": "string",
    "phoneNumber": "string"
  },
  "address": {
    "streetNumber": "string",
    "streetName": "string",
    "city": "string",
    "region": "string",
    "postalCode": "string",
    "country": "string"
  },
  "bankAccountIDs": [
    "string"
  ],
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Parameters

Name	In	Type	Required	Description
body	body	V3CreatePaymentServiceUserRequest	false	none

Example responses

201 Response

{
  "data": "string"
}

Responses

Status	Meaning	Description	Schema
201	Created	Created	V3CreatePaymentServiceUserResponse
default	Default	Error	V3ErrorResponse

List all payment service users

Code samples

GET /v3/payment-service-users HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/payment-service-users

Body parameter

{}

Parameters

Name	In	Type	Required	Description
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "data": [
      {
        "id": "string",
        "name": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "contactDetails": {
          "email": "string",
          "phoneNumber": "string"
        },
        "address": {
          "streetNumber": "string",
          "streetName": "string",
          "city": "string",
          "region": "string",
          "postalCode": "string",
          "country": "string"
        },
        "bankAccountIDs": [
          "string"
        ],
        "metadata": {
          "property1": "string",
          "property2": "string"
        }
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3PaymentServiceUsersCursorResponse
default	Default	Error	V3ErrorResponse

Get a payment service user by ID

Code samples

GET /v3/payment-service-users/{paymentServiceUserID} HTTP/1.1

Accept: application/json

GET /v3/payment-service-users/{paymentServiceUserID}

Parameters

Name	In	Type	Required	Description
paymentServiceUserID	path	string	true	The payment service user ID

Example responses

200 Response

{
  "data": {
    "id": "string",
    "name": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "contactDetails": {
      "email": "string",
      "phoneNumber": "string"
    },
    "address": {
      "streetNumber": "string",
      "streetName": "string",
      "city": "string",
      "region": "string",
      "postalCode": "string",
      "country": "string"
    },
    "bankAccountIDs": [
      "string"
    ],
    "metadata": {
      "property1": "string",
      "property2": "string"
    }
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3GetPaymentServiceUserResponse
default	Default	Error	V3ErrorResponse

Add a bank account to a payment service user

Code samples

POST /v3/payment-service-users/{paymentServiceUserID}/bank-accounts/{bankAccountID} HTTP/1.1

Accept: application/json

POST /v3/payment-service-users/{paymentServiceUserID}/bank-accounts/{bankAccountID}

Parameters

Name	In	Type	Required	Description
paymentServiceUserID	path	string	true	The payment service user ID
bankAccountID	path	string	true	The bank account ID

Example responses

default Response

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	No Content	None
default	Default	Error	V3ErrorResponse

Forward a payment service user's bank account to a connector

Code samples

POST /v3/payment-service-users/{paymentServiceUserID}/bank-accounts/{bankAccountID}/forward HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/payment-service-users/{paymentServiceUserID}/bank-accounts/{bankAccountID}/forward

Body parameter

{
  "connectorID": "string"
}

Parameters

Name	In	Type	Required	Description
paymentServiceUserID	path	string	true	The payment service user ID
bankAccountID	path	string	true	The bank account ID
body	body	V3ForwardPaymentServiceUserBankAccountRequest	false	none

Example responses

202 Response

{
  "data": {
    "taskID": "string"
  }
}

Responses

Status	Meaning	Description	Schema
202	Accepted	Accepted	V3ForwardPaymentServiceUserBankAccountResponse
default	Default	Error	V3ErrorResponse

Create a formance pool object

Code samples

POST /v3/pools HTTP/1.1

Content-Type: application/json
Accept: application/json

POST /v3/pools

Body parameter

{
  "name": "string",
  "accountIDs": [
    "string"
  ]
}

Parameters

Name	In	Type	Required	Description
body	body	V3CreatePoolRequest	false	none

Example responses

201 Response

{
  "data": "string"
}

Responses

Status	Meaning	Description	Schema
201	Created	Created	V3CreatePoolResponse
default	Default	Error	V3ErrorResponse

List all pools

Code samples

GET /v3/pools HTTP/1.1

Content-Type: application/json
Accept: application/json

GET /v3/pools

Body parameter

{}

Parameters

Name	In	Type	Required	Description
pageSize	query	integer(int64)	false	The number of items to return
cursor	query	string	false	Parameter used in pagination requests. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.
body	body	V3QueryBuilder	false	none

Detailed descriptions

Example responses

200 Response

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "name": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "poolAccounts": [
          "string"
        ]
      }
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3PoolsCursorResponse
default	Default	Error	V3ErrorResponse

Get a pool by ID

Code samples

GET /v3/pools/{poolID} HTTP/1.1

Accept: application/json

GET /v3/pools/{poolID}

Parameters

Name	In	Type	Required	Description
poolID	path	string	true	The pool ID

Example responses

200 Response

{
  "data": {
    "id": "string",
    "name": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "poolAccounts": [
      "string"
    ]
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3GetPoolResponse
default	Default	Error	V3ErrorResponse

Delete a pool by ID

Code samples

DELETE /v3/pools/{poolID} HTTP/1.1

Accept: application/json

DELETE /v3/pools/{poolID}

Parameters

Name	In	Type	Required	Description
poolID	path	string	true	The pool ID

Example responses

default Response

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	No Content	None
default	Default	Error	V3ErrorResponse

Get historical pool balances from a particular point in time

Code samples

GET /v3/pools/{poolID}/balances HTTP/1.1

Accept: application/json

GET /v3/pools/{poolID}/balances

Parameters

Name	In	Type	Required	Description
poolID	path	string	true	The pool ID
at	query	string(date-time)	false	The time to filter by

Example responses

200 Response

{
  "data": [
    {
      "asset": "string",
      "amount": 0
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3PoolBalancesResponse
default	Default	Error	V3ErrorResponse

Get latest pool balances

Code samples

GET /v3/pools/{poolID}/balances/latest HTTP/1.1

Accept: application/json

GET /v3/pools/{poolID}/balances/latest

Parameters

Name	In	Type	Required	Description
poolID	path	string	true	The pool ID

Example responses

200 Response

{
  "data": [
    {
      "asset": "string",
      "amount": 0
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3PoolBalancesResponse
default	Default	Error	V3ErrorResponse

Add an account to a pool

Code samples

POST /v3/pools/{poolID}/accounts/{accountID} HTTP/1.1

Accept: application/json

POST /v3/pools/{poolID}/accounts/{accountID}

Parameters

Name	In	Type	Required	Description
poolID	path	string	true	The pool ID
accountID	path	string	true	The account ID

Example responses

default Response

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	No Content	None
default	Default	Error	V3ErrorResponse

Remove an account from a pool

Code samples

DELETE /v3/pools/{poolID}/accounts/{accountID} HTTP/1.1

Accept: application/json

DELETE /v3/pools/{poolID}/accounts/{accountID}

Parameters

Name	In	Type	Required	Description
poolID	path	string	true	The pool ID
accountID	path	string	true	The account ID

Example responses

default Response

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Responses

Status	Meaning	Description	Schema
204	No Content	No Content	None
default	Default	Error	V3ErrorResponse

Get a task and its result by ID

Code samples

GET /v3/tasks/{taskID} HTTP/1.1

Accept: application/json

GET /v3/tasks/{taskID}

Parameters

Name	In	Type	Required	Description
taskID	path	string	true	The task ID

Example responses

200 Response

{
  "data": {
    "id": "string",
    "status": "PROCESSING",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "connectorID": "string",
    "createdObjectID": "string",
    "error": "string"
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	V3GetTaskResponse
default	Default	Error	V3ErrorResponse

Schemas

V3AccountID

"string"

Properties

Name	Type	Required	Restrictions	Description
anonymous	string	false	none	none

V3AccountsCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "provider": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "type": "UNKNOWN",
        "name": "string",
        "defaultAsset": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "raw": {}
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3Account]	true	none	none

V3GetAccountResponse

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "type": "UNKNOWN",
    "name": "string",
    "defaultAsset": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "raw": {}
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3Account	true	none	none

V3CreateAccountRequest

{
  "reference": "string",
  "connectorID": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "accountName": "string",
  "type": "UNKNOWN",
  "defaultAsset": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
reference	string	true	none	none
connectorID	string(byte)	true	none	none
createdAt	string(date-time)	true	none	none
accountName	string	true	none	none
type	V3AccountTypeEnum	true	none	none
defaultAsset	string¦null	false	none	none
metadata	V3Metadata	false	none	none

V3CreateAccountResponse

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "type": "UNKNOWN",
    "name": "string",
    "defaultAsset": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "raw": {}
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3Account	true	none	none

V3Account

{
  "id": "string",
  "connectorID": "string",
  "provider": "string",
  "reference": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "type": "UNKNOWN",
  "name": "string",
  "defaultAsset": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "raw": {}
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
connectorID	string(byte)	true	none	none
provider	string	true	none	none
reference	string	true	none	none
createdAt	string(date-time)	true	none	none
type	V3AccountTypeEnum	true	none	none
name	string¦null	false	none	none
defaultAsset	string¦null	false	none	none
metadata	V3Metadata	false	none	none
raw	object	true	none	none

V3AccountTypeEnum

"UNKNOWN"

Properties

Name	Type	Required	Restrictions	Description
anonymous	string	false	none	none

Enumerated Values

Property	Value
anonymous	UNKNOWN
anonymous	INTERNAL
anonymous	EXTERNAL

V3BalancesCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "accountID": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "lastUpdatedAt": "2019-08-24T14:15:22Z",
        "asset": "string",
        "balance": 0
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3Balance]	true	none	none

V3Balance

{
  "accountID": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "lastUpdatedAt": "2019-08-24T14:15:22Z",
  "asset": "string",
  "balance": 0
}

Properties

Name	Type	Required	Restrictions	Description
accountID	string	true	none	none
createdAt	string(date-time)	true	none	none
lastUpdatedAt	string(date-time)	true	none	none
asset	string	true	none	none
balance	integer(bigint)	true	none	none

V3CreateBankAccountRequest

{
  "name": "string",
  "accountNumber": "string",
  "iban": "string",
  "swiftBicCode": "string",
  "country": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
name	string	true	none	none
accountNumber	string	false	none	none
iban	string	false	none	none
swiftBicCode	string	false	none	none
country	string	false	none	none
metadata	V3Metadata	false	none	none

V3CreateBankAccountResponse

{
  "data": "string"
}

Properties

Name	Type	Required	Restrictions	Description
data	string	true	none	The ID of the created bank account

V3UpdateBankAccountMetadataRequest

{
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
metadata	V3Metadata	true	none	none

V3ForwardBankAccountRequest

{
  "connectorID": "string"
}

Properties

Name	Type	Required	Restrictions	Description
connectorID	string(byte)	true	none	none

V3ForwardBankAccountResponse

{
  "data": {
    "taskID": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	object	true	none	none
» taskID	string	true	none	Since this call is asynchronous, the response will contain the ID of the task that was created to forward the bank account to the PSP. You can use the task API to check the status of the task and get the resulting bank account ID.

V3BankAccountsCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "accountNumber": "string",
        "iban": "string",
        "swiftBicCode": "string",
        "country": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "relatedAccounts": [
          {
            "accountID": "string",
            "createdAt": "2019-08-24T14:15:22Z"
          }
        ]
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3BankAccount]	true	none	none

V3GetBankAccountResponse

{
  "data": {
    "id": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "name": "string",
    "accountNumber": "string",
    "iban": "string",
    "swiftBicCode": "string",
    "country": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "relatedAccounts": [
      {
        "accountID": "string",
        "createdAt": "2019-08-24T14:15:22Z"
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3BankAccount	true	none	none

V3BankAccount

{
  "id": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "name": "string",
  "accountNumber": "string",
  "iban": "string",
  "swiftBicCode": "string",
  "country": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "relatedAccounts": [
    {
      "accountID": "string",
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
createdAt	string(date-time)	true	none	none
name	string	true	none	none
accountNumber	string¦null	false	none	none
iban	string¦null	false	none	none
swiftBicCode	string¦null	false	none	none
country	string¦null	false	none	none
metadata	V3Metadata	false	none	none
relatedAccounts	[V3BankAccountRelatedAccount]	false	none	none

V3BankAccountRelatedAccount

{
  "accountID": "string",
  "createdAt": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
accountID	string	true	none	none
createdAt	string(date-time)	true	none	none

V3InstallConnectorRequest

{
  "apiKey": "string",
  "companyID": "string",
  "liveEndpointPrefix": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Adyen",
  "webhookPassword": "string",
  "webhookUsername": "string"
}

Properties

None

V3InstallConnectorResponse

{
  "data": "string"
}

Properties

Name	Type	Required	Restrictions	Description
data	string	true	none	The ID of the created connector

V3UninstallConnectorResponse

{
  "data": {
    "taskID": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	object	true	none	none
» taskID	string	true	none	Since this call is asynchronous, the response will contain the ID of the task that was created to uninstall the connector. You can use the task API to check the status of the task and get the results.

V3ResetConnectorResponse

{
  "data": "string"
}

Properties

Name	Type	Required	Restrictions	Description
data	string	true	none	Since this call is asynchronous, the response will contain the ID of the task that was created to reset the connector. You can use the task API to check the status of the task and get the results.

V3ConnectorConfigsResponse

{
  "data": {
    "property1": {
      "property1": {
        "dataType": "string",
        "required": true,
        "defaultValue": "string"
      },
      "property2": {
        "dataType": "string",
        "required": true,
        "defaultValue": "string"
      }
    },
    "property2": {
      "property1": {
        "dataType": "string",
        "required": true,
        "defaultValue": "string"
      },
      "property2": {
        "dataType": "string",
        "required": true,
        "defaultValue": "string"
      }
    }
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	object	true	none	none
» additionalProperties	object	false	none	none
»» additionalProperties	object	false	none	none
»»» dataType	string	true	none	none
»»» required	boolean	true	none	none
»»» defaultValue	string	false	none	none

V3GetConnectorConfigResponse

{
  "data": {
    "apiKey": "string",
    "companyID": "string",
    "liveEndpointPrefix": "string",
    "name": "string",
    "pageSize": "25",
    "pollingPeriod": "2m",
    "provider": "Adyen",
    "webhookPassword": "string",
    "webhookUsername": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3ConnectorConfig	true	none	none

V3UpdateConnectorRequest

{
  "apiKey": "string",
  "companyID": "string",
  "liveEndpointPrefix": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Adyen",
  "webhookPassword": "string",
  "webhookUsername": "string"
}

Properties

None

V3ConnectorsCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "reference": "string",
        "name": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "provider": "string",
        "scheduledForDeletion": true,
        "config": {}
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3Connector]	true	none	none

V3ConnectorSchedulesCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "createdAt": "2019-08-24T14:15:22Z"
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3Schedule]	true	none	none

V3ConnectorScheduleResponse

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "createdAt": "2019-08-24T14:15:22Z"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3Schedule	true	none	none

V3ConnectorScheduleInstancesCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "scheduleID": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "terminated": true,
        "terminatedAt": "2019-08-24T14:15:22Z",
        "error": "string"
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3Instance]	true	none	none

V3Connector

{
  "id": "string",
  "reference": "string",
  "name": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "provider": "string",
  "scheduledForDeletion": true,
  "config": {}
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
reference	string	true	none	none
name	string	true	none	none
createdAt	string(date-time)	true	none	none
provider	string	true	none	none
scheduledForDeletion	boolean	true	none	none
config	object	true	none	none

V3Schedule

{
  "id": "string",
  "connectorID": "string",
  "createdAt": "2019-08-24T14:15:22Z"
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
connectorID	string(byte)	true	none	none
createdAt	string(date-time)	true	none	none

V3Instance

{
  "id": "string",
  "connectorID": "string",
  "scheduleID": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "terminated": true,
  "terminatedAt": "2019-08-24T14:15:22Z",
  "error": "string"
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
connectorID	string(byte)	true	none	none
scheduleID	string	true	none	none
createdAt	string(date-time)	true	none	none
updatedAt	string(date-time)	true	none	none
terminated	boolean	true	none	none
terminatedAt	string(date-time)	false	none	none
error	string¦null	false	none	none

V3CreatePaymentRequest

{
  "reference": "string",
  "connectorID": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "type": "UNKNOWN",
  "initialAmount": 0,
  "amount": 0,
  "asset": "string",
  "scheme": "string",
  "sourceAccountID": "string",
  "destinationAccountID": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "adjustments": [
    {
      "reference": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "status": "UNKNOWN",
      "amount": 0,
      "asset": "string",
      "metadata": {
        "property1": "string",
        "property2": "string"
      }
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
reference	string	true	none	none
connectorID	string(byte)	true	none	none
createdAt	string(date-time)	true	none	none
type	V3PaymentTypeEnum	true	none	none
initialAmount	integer(bigint)	true	none	none
amount	integer(bigint)	true	none	none
asset	string	true	none	none
scheme	string	true	none	none
sourceAccountID	string(byte)	false	none	none
destinationAccountID	string(byte)	false	none	none
metadata	V3Metadata	false	none	none
adjustments	[V3CreatePaymentAdjustmentRequest]	false	none	none

V3CreatePaymentAdjustmentRequest

{
  "reference": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "status": "UNKNOWN",
  "amount": 0,
  "asset": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
reference	string	true	none	none
createdAt	string(date-time)	true	none	none
status	V3PaymentStatusEnum	true	none	none
amount	integer(bigint)	false	none	none
asset	string	false	none	none
metadata	V3Metadata	false	none	none

V3CreatePaymentResponse

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "type": "UNKNOWN",
    "initialAmount": 0,
    "amount": 0,
    "asset": "string",
    "scheme": "string",
    "status": "UNKNOWN",
    "sourceAccountID": "string",
    "destinationAccountID": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "adjustments": [
      {
        "id": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "status": "UNKNOWN",
        "amount": 0,
        "asset": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "raw": {}
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3Payment	true	none	none

V3UpdatePaymentMetadataRequest

{
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
metadata	V3Metadata	true	none	none

V3PaymentsCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "provider": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "type": "UNKNOWN",
        "initialAmount": 0,
        "amount": 0,
        "asset": "string",
        "scheme": "string",
        "status": "UNKNOWN",
        "sourceAccountID": "string",
        "destinationAccountID": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "adjustments": [
          {
            "id": "string",
            "reference": "string",
            "createdAt": "2019-08-24T14:15:22Z",
            "status": "UNKNOWN",
            "amount": 0,
            "asset": "string",
            "metadata": {
              "property1": "string",
              "property2": "string"
            },
            "raw": {}
          }
        ]
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3Payment]	true	none	none

V3GetPaymentResponse

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "type": "UNKNOWN",
    "initialAmount": 0,
    "amount": 0,
    "asset": "string",
    "scheme": "string",
    "status": "UNKNOWN",
    "sourceAccountID": "string",
    "destinationAccountID": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "adjustments": [
      {
        "id": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "status": "UNKNOWN",
        "amount": 0,
        "asset": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "raw": {}
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3Payment	true	none	none

V3Payment

{
  "id": "string",
  "connectorID": "string",
  "provider": "string",
  "reference": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "type": "UNKNOWN",
  "initialAmount": 0,
  "amount": 0,
  "asset": "string",
  "scheme": "string",
  "status": "UNKNOWN",
  "sourceAccountID": "string",
  "destinationAccountID": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "adjustments": [
    {
      "id": "string",
      "reference": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "status": "UNKNOWN",
      "amount": 0,
      "asset": "string",
      "metadata": {
        "property1": "string",
        "property2": "string"
      },
      "raw": {}
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
connectorID	string(byte)	true	none	none
provider	string	true	none	none
reference	string	true	none	none
createdAt	string(date-time)	true	none	none
type	V3PaymentTypeEnum	true	none	none
initialAmount	integer(bigint)	true	none	none
amount	integer(bigint)	true	none	none
asset	string	true	none	none
scheme	string	true	none	none
status	V3PaymentStatusEnum	true	none	none
sourceAccountID	string(byte)¦null	false	none	none
destinationAccountID	string(byte)¦null	false	none	none
metadata	V3Metadata	false	none	none
adjustments	[V3PaymentAdjustment]¦null	false	none	none

V3PaymentAdjustment

{
  "id": "string",
  "reference": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "status": "UNKNOWN",
  "amount": 0,
  "asset": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "raw": {}
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
reference	string	true	none	none
createdAt	string(date-time)	true	none	none
status	V3PaymentStatusEnum	true	none	none
amount	integer(bigint)	false	none	none
asset	string	false	none	none
metadata	V3Metadata	false	none	none
raw	object	true	none	none

V3PaymentTypeEnum

"UNKNOWN"

Properties

Name	Type	Required	Restrictions	Description
anonymous	string	false	none	none

Enumerated Values

Property	Value
anonymous	UNKNOWN
anonymous	PAY-IN
anonymous	PAYOUT
anonymous	TRANSFER
anonymous	OTHER

V3PaymentStatusEnum

"UNKNOWN"

Properties

Name	Type	Required	Restrictions	Description
anonymous	string	false	none	none

Enumerated Values

Property	Value
anonymous	UNKNOWN
anonymous	PENDING
anonymous	SUCCEEDED
anonymous	CANCELLED
anonymous	FAILED
anonymous	EXPIRED
anonymous	REFUNDED
anonymous	REFUNDED_FAILURE
anonymous	REFUND_REVERSED
anonymous	DISPUTE
anonymous	DISPUTE_WON
anonymous	DISPUTE_LOST
anonymous	AMOUNT_ADJUSTEMENT
anonymous	AUTHORISATION
anonymous	CAPTURE
anonymous	CAPTURE_FAILED
anonymous	OTHER

V3InitiatePaymentRequest

{
  "reference": "string",
  "scheduledAt": "2019-08-24T14:15:22Z",
  "connectorID": "string",
  "description": "string",
  "type": "UNKNOWN",
  "amount": 0,
  "asset": "string",
  "sourceAccountID": "string",
  "destinationAccountID": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
reference	string	true	none	none
scheduledAt	string(date-time)	true	none	none
connectorID	string(byte)	true	none	none
description	string	true	none	none
type	V3PaymentInitiationTypeEnum	true	none	none
amount	integer(bigint)	true	none	none
asset	string	true	none	none
sourceAccountID	string(byte)¦null	false	none	none
destinationAccountID	string(byte)	false	none	none
metadata	V3Metadata	false	none	none

V3InitiatePaymentResponse

{
  "data": {
    "paymentInitiationID": "string",
    "taskID": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	object	true	none	none
» paymentInitiationID	string	false	none	Related payment initiation object ID created.
» taskID	string	false	none	Will be filled if the noValidation query parameter is set to true. Since this call is asynchronous, the response will contain the ID of the task that was created to create the payment on the PSP. You can use the task API to check the status of the task and get the resulting payment ID

V3RetryPaymentInitiationResponse

{
  "data": {
    "taskID": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	object	true	none	none
» taskID	string	true	none	Since this call is asynchronous, the response will contain the ID of the task that was created to retry the payment initiation to the PSP. You can use the task API to check the status of the task and get the resulting payment ID.

V3ApprovePaymentInitiationResponse

{
  "data": {
    "taskID": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	object	true	none	none
» taskID	string	true	none	Since this call is asynchronous, the response will contain the ID of the task that was created to approve the payment initiation. You can use the task API to check the status of the task and get the resulting payment ID.

V3ReversePaymentInitiationRequest

{
  "reference": "string",
  "description": "string",
  "amount": 0,
  "asset": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
reference	string	true	none	none
description	string	true	none	none
amount	integer(bigint)	true	none	none
asset	string	true	none	none
metadata	V3Metadata	false	none	none

V3ReversePaymentInitiationResponse

{
  "data": {
    "taskID": "string",
    "paymentInitiationReversalID": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	object	true	none	none
» taskID	string	false	none	Since this call is asynchronous, the response will contain the ID of the task that was created to reverse the payment initiation. You can use the task API to check the status of the task and get the resulting payment ID.
» paymentInitiationReversalID	string	false	none	Related payment initiation reversal object ID created.

V3PaymentInitiationsCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "provider": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "scheduledAt": "2019-08-24T14:15:22Z",
        "description": "string",
        "type": "UNKNOWN",
        "amount": 0,
        "asset": "string",
        "status": "UNKNOWN",
        "sourceAccountID": "string",
        "destinationAccountID": "string",
        "error": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        }
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3PaymentInitiation]	true	none	none

V3PaymentInitiationAdjustmentsCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "status": "UNKNOWN",
        "amount": 0,
        "asset": "string",
        "error": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        }
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3PaymentInitiationAdjustment]	true	none	none

V3PaymentInitiationRelatedPaymentsCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "connectorID": "string",
        "provider": "string",
        "reference": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "type": "UNKNOWN",
        "initialAmount": 0,
        "amount": 0,
        "asset": "string",
        "scheme": "string",
        "status": "UNKNOWN",
        "sourceAccountID": "string",
        "destinationAccountID": "string",
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "adjustments": [
          {
            "id": "string",
            "reference": "string",
            "createdAt": "2019-08-24T14:15:22Z",
            "status": "UNKNOWN",
            "amount": 0,
            "asset": "string",
            "metadata": {
              "property1": "string",
              "property2": "string"
            },
            "raw": {}
          }
        ]
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3Payment]	true	none	none

V3PaymentInitiation

{
  "id": "string",
  "connectorID": "string",
  "provider": "string",
  "reference": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "scheduledAt": "2019-08-24T14:15:22Z",
  "description": "string",
  "type": "UNKNOWN",
  "amount": 0,
  "asset": "string",
  "status": "UNKNOWN",
  "sourceAccountID": "string",
  "destinationAccountID": "string",
  "error": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
connectorID	string(byte)	true	none	none
provider	string	true	none	none
reference	string	true	none	none
createdAt	string(date-time)	true	none	none
scheduledAt	string(date-time)	true	none	none
description	string	true	none	none
type	V3PaymentInitiationTypeEnum	true	none	none
amount	integer(bigint)	true	none	none
asset	string	true	none	none
status	V3PaymentInitiationStatusEnum	true	none	none
sourceAccountID	string(byte)	false	none	none
destinationAccountID	string(byte)	false	none	none
error	string¦null	false	none	none
metadata	V3Metadata	false	none	none

V3PaymentInitiationAdjustment

{
  "id": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "status": "UNKNOWN",
  "amount": 0,
  "asset": "string",
  "error": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
createdAt	string(date-time)	true	none	none
status	V3PaymentInitiationStatusEnum	true	none	none
amount	integer(bigint)	false	none	none
asset	string	false	none	none
error	string¦null	false	none	none
metadata	V3Metadata	false	none	none

V3GetPaymentInitiationResponse

{
  "data": {
    "id": "string",
    "connectorID": "string",
    "provider": "string",
    "reference": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "scheduledAt": "2019-08-24T14:15:22Z",
    "description": "string",
    "type": "UNKNOWN",
    "amount": 0,
    "asset": "string",
    "status": "UNKNOWN",
    "sourceAccountID": "string",
    "destinationAccountID": "string",
    "error": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    }
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3PaymentInitiation	true	none	none

V3PaymentInitiationStatusEnum

"UNKNOWN"

Properties

Name	Type	Required	Restrictions	Description
anonymous	string	false	none	none

Enumerated Values

Property	Value
anonymous	UNKNOWN
anonymous	WAITING_FOR_VALIDATION
anonymous	SCHEDULED_FOR_PROCESSING
anonymous	PROCESSING
anonymous	PROCESSED
anonymous	FAILED
anonymous	REJECTED
anonymous	REVERSE_PROCESSING
anonymous	REVERSE_FAILED
anonymous	REVERSED

V3PaymentInitiationTypeEnum

"UNKNOWN"

Properties

Name	Type	Required	Restrictions	Description
anonymous	string	false	none	none

Enumerated Values

Property	Value
anonymous	UNKNOWN
anonymous	TRANSFER
anonymous	PAYOUT

V3CreatePaymentServiceUserRequest

{
  "name": "string",
  "contactDetails": {
    "email": "string",
    "phoneNumber": "string"
  },
  "address": {
    "streetNumber": "string",
    "streetName": "string",
    "city": "string",
    "region": "string",
    "postalCode": "string",
    "country": "string"
  },
  "bankAccountIDs": [
    "string"
  ],
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
name	string	true	none	none
contactDetails	V3ContactDetailsRequest	false	none	none
address	V3AddressRequest	false	none	none
bankAccountIDs	[string]¦null	false	none	none
metadata	V3Metadata	false	none	none

V3AddressRequest

{
  "streetNumber": "string",
  "streetName": "string",
  "city": "string",
  "region": "string",
  "postalCode": "string",
  "country": "string"
}

Properties

Name	Type	Required	Restrictions	Description
streetNumber	string	false	none	none
streetName	string	false	none	none
city	string	false	none	none
region	string	false	none	none
postalCode	string	false	none	none
country	string	false	none	none

V3ContactDetailsRequest

{
  "email": "string",
  "phoneNumber": "string"
}

Properties

Name	Type	Required	Restrictions	Description
email	string	false	none	none
phoneNumber	string	false	none	none

V3CreatePaymentServiceUserResponse

{
  "data": "string"
}

Properties

Name	Type	Required	Restrictions	Description
data	string	true	none	The ID of the created payment service user

V3PaymentServiceUsersCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "data": [
      {
        "id": "string",
        "name": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "contactDetails": {
          "email": "string",
          "phoneNumber": "string"
        },
        "address": {
          "streetNumber": "string",
          "streetName": "string",
          "city": "string",
          "region": "string",
          "postalCode": "string",
          "country": "string"
        },
        "bankAccountIDs": [
          "string"
        ],
        "metadata": {
          "property1": "string",
          "property2": "string"
        }
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3PaymentServiceUser]	true	none	none

V3PaymentServiceUser

{
  "id": "string",
  "name": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "contactDetails": {
    "email": "string",
    "phoneNumber": "string"
  },
  "address": {
    "streetNumber": "string",
    "streetName": "string",
    "city": "string",
    "region": "string",
    "postalCode": "string",
    "country": "string"
  },
  "bankAccountIDs": [
    "string"
  ],
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
name	string	true	none	none
createdAt	string(date-time)	true	none	none
contactDetails	V3ContactDetails	false	none	none
address	V3Address	false	none	none
bankAccountIDs	[string]¦null	false	none	none
metadata	V3Metadata	false	none	none

V3ContactDetails

{
  "email": "string",
  "phoneNumber": "string"
}

Properties

Name	Type	Required	Restrictions	Description
email	string	false	none	none
phoneNumber	string	false	none	none

V3Address

{
  "streetNumber": "string",
  "streetName": "string",
  "city": "string",
  "region": "string",
  "postalCode": "string",
  "country": "string"
}

Properties

Name	Type	Required	Restrictions	Description
streetNumber	string	false	none	none
streetName	string	false	none	none
city	string	false	none	none
region	string	false	none	none
postalCode	string	false	none	none
country	string	false	none	none

V3GetPaymentServiceUserResponse

{
  "data": {
    "id": "string",
    "name": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "contactDetails": {
      "email": "string",
      "phoneNumber": "string"
    },
    "address": {
      "streetNumber": "string",
      "streetName": "string",
      "city": "string",
      "region": "string",
      "postalCode": "string",
      "country": "string"
    },
    "bankAccountIDs": [
      "string"
    ],
    "metadata": {
      "property1": "string",
      "property2": "string"
    }
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3PaymentServiceUser	true	none	none

V3ForwardPaymentServiceUserBankAccountRequest

{
  "connectorID": "string"
}

Properties

Name	Type	Required	Restrictions	Description
connectorID	string(byte)	true	none	none

V3ForwardPaymentServiceUserBankAccountResponse

{
  "data": {
    "taskID": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	object	true	none	none
» taskID	string	true	none	Since this call is asynchronous, the response will contain the ID of the task that was created to forward the bank account to the PSP. You can use the task API to check the status of the task and get the resulting bank account ID.

V3CreatePoolRequest

{
  "name": "string",
  "accountIDs": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
name	string	true	none	none
accountIDs	[string]	true	none	none

V3CreatePoolResponse

{
  "data": "string"
}

Properties

Name	Type	Required	Restrictions	Description
data	string	true	none	The ID of the created pool

V3PoolsCursorResponse

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": "",
    "data": [
      {
        "id": "string",
        "name": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "poolAccounts": [
          "string"
        ]
      }
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
cursor	object	true	none	none
» pageSize	integer(int64)	true	none	none
» hasMore	boolean	true	none	none
» previous	string	false	none	none
» next	string	false	none	none
» data	[V3Pool]	true	none	none

V3GetPoolResponse

{
  "data": {
    "id": "string",
    "name": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "poolAccounts": [
      "string"
    ]
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3Pool	true	none	none

V3PoolBalancesResponse

{
  "data": [
    {
      "asset": "string",
      "amount": 0
    }
  ]
}

Properties

Name	Type	Required	Restrictions	Description
data	V3PoolBalances	true	none	none

V3Pool

{
  "id": "string",
  "name": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "poolAccounts": [
    "string"
  ]
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
name	string	true	none	none
createdAt	string(date-time)	true	none	none
poolAccounts	[V3AccountID]	true	none	none

V3PoolBalances

[
  {
    "asset": "string",
    "amount": 0
  }
]

Properties

Name	Type	Required	Restrictions	Description
anonymous	[V3PoolBalance]	false	none	none

V3PoolBalance

{
  "asset": "string",
  "amount": 0
}

Properties

Name	Type	Required	Restrictions	Description
asset	string	true	none	none
amount	integer(bigint)	true	none	none

V3GetTaskResponse

{
  "data": {
    "id": "string",
    "status": "PROCESSING",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "connectorID": "string",
    "createdObjectID": "string",
    "error": "string"
  }
}

Properties

Name	Type	Required	Restrictions	Description
data	V3Task	true	none	none

V3Task

{
  "id": "string",
  "status": "PROCESSING",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "connectorID": "string",
  "createdObjectID": "string",
  "error": "string"
}

Properties

Name	Type	Required	Restrictions	Description
id	string	true	none	none
status	V3TaskStatusEnum	true	none	none
createdAt	string(date-time)	true	none	none
updatedAt	string(date-time)	true	none	none
connectorID	string(byte)	false	none	none
createdObjectID	string	false	none	none
error	string¦null	false	none	none

V3TaskStatusEnum

"PROCESSING"

Properties

Name	Type	Required	Restrictions	Description
anonymous	string	false	none	none

Enumerated Values

Property	Value
anonymous	PROCESSING
anonymous	SUCCEEDED
anonymous	FAILED

V3QueryBuilder

{}

Properties

None

V3Metadata

{
  "property1": "string",
  "property2": "string"
}

Properties

Name	Type	Required	Restrictions	Description
additionalProperties	string	false	none	none

V3ErrorResponse

{
  "errorCode": "VALIDATION",
  "errorMessage": "[VALIDATION] missing required config field: pollingPeriod",
  "details": "string"
}

Properties

Name	Type	Required	Restrictions	Description
errorCode	V3ErrorsEnum	true	none	none
errorMessage	string	true	none	none
details	string	false	none	none

V3ErrorsEnum

"VALIDATION"

Properties

Name	Type	Required	Restrictions	Description
anonymous	string	false	none	none

Enumerated Values

Property	Value
anonymous	INTERNAL
anonymous	VALIDATION
anonymous	INVALID_ID
anonymous	MISSING_OR_INVALID_BODY
anonymous	CONFLICT
anonymous	NOT_FOUND

V3ConnectorConfig

{
  "apiKey": "string",
  "companyID": "string",
  "liveEndpointPrefix": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Adyen",
  "webhookPassword": "string",
  "webhookUsername": "string"
}

Properties

oneOf

Name	Type	Required	Restrictions	Description
anonymous	V3AdyenConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3AtlarConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3BankingcircleConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3ColumnConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3CurrencycloudConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3DummypayConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3GenericConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3MangopayConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3ModulrConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3MoneycorpConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3QontoConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3StripeConfig	false	none	none

xor

Name	Type	Required	Restrictions	Description
anonymous	V3WiseConfig	false	none	none

V3AdyenConfig

{
  "apiKey": "string",
  "companyID": "string",
  "liveEndpointPrefix": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Adyen",
  "webhookPassword": "string",
  "webhookUsername": "string"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
companyID	string	true	none	none
liveEndpointPrefix	string	false	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none
webhookPassword	string	false	none	none
webhookUsername	string	false	none	none

V3AtlarConfig

{
  "accessKey": "string",
  "baseUrl": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Atlar",
  "secret": "string"
}

Properties

Name	Type	Required	Restrictions	Description
accessKey	string	true	none	none
baseUrl	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none
secret	string	true	none	none

V3BankingcircleConfig

{
  "authorizationEndpoint": "string",
  "endpoint": "string",
  "name": "string",
  "pageSize": "25",
  "password": "string",
  "pollingPeriod": "2m",
  "provider": "Bankingcircle",
  "userCertificate": "string",
  "userCertificateKey": "string",
  "username": "string"
}

Properties

Name	Type	Required	Restrictions	Description
authorizationEndpoint	string	true	none	none
endpoint	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
password	string	true	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none
userCertificate	string	true	none	none
userCertificateKey	string	true	none	none
username	string	true	none	none

V3ColumnConfig

{
  "apiKey": "string",
  "endpoint": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Column"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
endpoint	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none

V3CurrencycloudConfig

{
  "apiKey": "string",
  "endpoint": "string",
  "loginID": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Currencycloud"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
endpoint	string	true	none	none
loginID	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none

V3DummypayConfig

{
  "directory": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Dummypay"
}

Properties

Name	Type	Required	Restrictions	Description
directory	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none

V3GenericConfig

{
  "apiKey": "string",
  "endpoint": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Generic"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
endpoint	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none

V3MangopayConfig

{
  "apiKey": "string",
  "clientID": "string",
  "endpoint": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Mangopay"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
clientID	string	true	none	none
endpoint	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none

V3ModulrConfig

{
  "apiKey": "string",
  "apiSecret": "string",
  "endpoint": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Modulr"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
apiSecret	string	true	none	none
endpoint	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none

V3MoneycorpConfig

{
  "apiKey": "string",
  "clientID": "string",
  "endpoint": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Moneycorp"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
clientID	string	true	none	none
endpoint	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none

V3QontoConfig

{
  "apiKey": "string",
  "clientID": "string",
  "endpoint": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Qonto",
  "stagingToken": "string"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
clientID	string	true	none	none
endpoint	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none
stagingToken	string	false	none	none

V3StripeConfig

{
  "apiKey": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Stripe"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none

V3WiseConfig

{
  "apiKey": "string",
  "name": "string",
  "pageSize": "25",
  "pollingPeriod": "2m",
  "provider": "Wise",
  "webhookPublicKey": "string"
}

Properties

Name	Type	Required	Restrictions	Description
apiKey	string	true	none	none
name	string	true	none	none
pageSize	integer	false	none	none
pollingPeriod	string	false	none	none
provider	string	false	none	none
webhookPublicKey	string	true	none	none

147 KiB Raw Permalink Blame History

Payments API v1

payments.v1

Get server info

Responses

Response Schema

payments.v3

Create a formance account object. This object will not be forwarded to the connector. It is only used for internal purposes.

Parameters

Responses

List all accounts

Parameters

Detailed descriptions

Responses

Get an account by ID

Parameters

Responses

Get account balances

Parameters

Detailed descriptions

Responses

Create a formance bank account object. This object will not be forwarded to the connector until you called the forwardBankAccount method.

Parameters

Responses

List all bank accounts

Parameters

Detailed descriptions

Responses

Get a Bank Account by ID

Parameters

Responses

Update a bank account's metadata

Parameters

Responses

Forward a Bank Account to a PSP for creation

Parameters

Responses

List all connectors

Parameters

Detailed descriptions

Responses

Install a connector

Parameters

Responses

List all connector configurations

Responses

Uninstall a connector

Parameters

Responses

Get a connector configuration by ID

Parameters

Responses

Update the config of a connector

Parameters

Responses

Reset a connector. Be aware that this will delete all data and stop all existing tasks like payment initiations and bank account creations.

Parameters

Responses

List all connector schedules

Parameters

Detailed descriptions

Responses

Get a connector schedule by ID

Parameters

Responses

List all connector schedule instances

Parameters

Detailed descriptions

Responses

Create a formance payment object. This object will not be forwarded to the connector. It is only used for internal purposes.

Parameters

Responses

List all payments

Parameters

Detailed descriptions

Responses

Get a payment by ID

Parameters

Responses

Update a payment's metadata

147 KiB

Raw Permalink Blame History