API Explorer

v4.0.0 (329 APIs)

Bank
Accounts
Views
Counterparties
Transactions

Create Direct Debit

Create direct debit for an account.

Authentication is Mandatory

Typical Successful Response:

								
									
{ "direct_debit_id":"aa0533bd-eb22-4bff-af75-d45240361b05", "bank_id":"gh.29.uk", "account_id":"8ca8a7e4-6d02-40e3-a129-0b2bf89de9f0", "customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh", "user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1", "counterparty_id":"9fg8a7e4-6d02-40e3-a129-0b2bf89de8uh", "date_signed":"2020-10-25T00:50:39Z", "date_starts":"2020-10-25T00:50:39Z", "date_expires":"2020-10-25T00:50:39Z", "date_cancelled":"2020-10-25T00:50:39Z", "active":true }
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-30018: Bank Account not found. Please specify valid values for BANK_ID and ACCOUNT_ID.
  • OBP-30022: The current view does not have the permission:
  • OBP-20017: Current user does not have access to the view. Please specify a valid value for VIEW_ID.
  • OBP-10001: Incorrect json format.
  • OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
  • OBP-20057: User not found by userId.
  • OBP-30017: Counterparty not found. Please specify a valid value for COUNTERPARTY_ID.
  • OBP-50000: Unknown Error.
Implemented in OBPv4.0.0 by createDirectDebit

Create Direct Debit (management)

Create direct debit for an account.

Authentication is Mandatory

Typical Successful Response:

								
									
{ "direct_debit_id":"aa0533bd-eb22-4bff-af75-d45240361b05", "bank_id":"gh.29.uk", "account_id":"8ca8a7e4-6d02-40e3-a129-0b2bf89de9f0", "customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh", "user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1", "counterparty_id":"9fg8a7e4-6d02-40e3-a129-0b2bf89de8uh", "date_signed":"2020-10-25T00:50:39Z", "date_starts":"2020-10-25T00:50:39Z", "date_expires":"2020-10-25T00:50:39Z", "date_cancelled":"2020-10-25T00:50:39Z", "active":true }
Required Roles:
  • CanCreateDirectDebitAtOneBank - Please login to request this Role
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-30018: Bank Account not found. Please specify valid values for BANK_ID and ACCOUNT_ID.
  • OBP-30022: The current view does not have the permission:
  • OBP-10001: Incorrect json format.
  • OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
  • OBP-20057: User not found by userId.
  • OBP-30017: Counterparty not found. Please specify a valid value for COUNTERPARTY_ID.
  • OBP-50000: Unknown Error.
  • OBP-20006: User is missing one or more roles:
Implemented in OBPv4.0.0 by createDirectDebitManagement