Skip to main content
The Open Banking connector supports the following operations from the Grand Central Unified API.

​
Supported operations

Grand Central Unified API domainGrand Central Unified API method and endpointOperation
Servicing ConsentPOST {consentBaseUrl}/consentsInitiates the consent process by validating an authorization URL received from an AISP, triggered by redirection from the AISP. In response, the endpoint retrieves the consent information from the consent’s source of truth. The digital banking app of the ASPSP calls this endpoint (for example, Backbase Identity) before the end user logs in and consents to the data sharing request.
Servicing ConsentPATCH {consentBaseUrl}/consents/{consentId}Updates an existing consent by attaching account and consent approval information. The digital banking layer calls this operation after Strong Customer Authentication (SCA), when the user logs in, associates accounts with the consent, and grants or denies the consent.
Servicing ConsentDELETE {consentBaseUrl}/{scheme}/{type}/consents/{consentId}Revokes an existing consent.
DepositGET {depositBaseUrl}/deposits/{depositId}Returns the details of the deposit account and balances by ID.
DepositGET {depositBaseUrl}/deposits/{depositId}/transactionsReturns the transactions for the deposit account by the given parameters.
Payment OrderPOST {paymentOrderBaseUrl}/payments/accounts/{accountId}Retrieves the list of standing orders and future scheduled payments associated with the requested account.

​
Error mapping

The Open Banking connector integrates with two third-party systems: Salt Edge for consent management and the Backbase Engagement Banking Platform (EBP) for account information retrieval. The following tables map each third-party error code to its Grand Central counterpart.

​
Salt Edge error mapping

The following table maps each Salt Edge error code to its Grand Central error code:
Salt Edge codeGrand Central code
RouteNotFoundGC054
TokenNotFoundGC054
AccountNotFoundGC054
ConsentNotFoundGC054
PaymentNotFoundGC054
ProviderNotFoundGC054
SessionNotFoundGC054
CustomerNotFoundGC054
ConsentExpiredGC002
ConsentFinalisedGC702
TokenExpiredGC002
InvalidCredentialsGC002
AccessDeniedGC002
PaymentFinalisedGC002
BasketFinalisedGC002
SessionExpiredGC002
InvalidEncodingGC067
ValueOutOfRangeGC025
WrongRequestFormatGC024
AuthorizationMissingGC007
InvalidAuthorizationTypeGC001
JWTDecodeErrorGC008
JWTExpiredSignatureGC008
JWTVerificationErrorGC008
JWTIncorrectAlgorithmGC008
AccessTokenMissingGC008
AccountsRefreshFailedGC103
HttpRequestFailedGC001
AuthorisationDeniedGC004
InternalServerErrorGC027

​
Backbase EBP error mapping

The following table maps each Backbase Engagement Banking Platform error code to its Grand Central error code:
Backbase EBP codeGrand Central code
arrangements.api.notFound.arrangementGC201
arrangements.api.parentNotFound.arrangementGC201
arrangements.api.blank.GC025
arrangements.api.notFound.balanceHistoryGC201
arrangements.api.notFound.productGC201
arrangements.api.notNull.atLeastOneGC025
arrangements.api.badFormat.arrangementsIdentifiersPairsGC024
arrangements.api.legalEntities.notRelatedGC201
arrangements.api.legalEntities.atLeastOneGC201
Arrangement.apiGC025
account.arrangement.apiGC024
arrangements.api.batch.maxSizeExceededGC052
Arrangement.balanceHistory.apiGC201
getArrangementById.arrangementId.SizeGC025
account.product.apiGC201
arrangement.view.mapping.attributeGC025
account.api.notFound.userGC201
account.api.arrangement.legalEntityNotExistGC201
account.api.arrangement.invalid.legalEntitiesPairGC025
account.api.arrangement.duplicated.internalLegalEntityIdsGC025
account.api.arrangement.duplicated.externalLegalEntityIdsGC025
account.api.arrangements.getLinkedGC004
arrangements.api.notFound.stateGC201
account.api.invalidBody.userGC024
account.api.invalidBody.accessGroupGC024
account.api.arrangement.notEntitledToSeeGC004
account.api.arrangementNoPrivilegeGC004
account.api.noPrivilege.userGC004
arrangements.api.notFound.userPreferencesGC201
account.api.arrangement.removeGC201
account.api.arrangement.getRecipientArrangementsListGC201
account.api.arrangement.getBalancesGC201
account.api.arrangement.getArrangementsByLegalEntityGC201
account.api.arrangement.invalidComboOfPeriodRangeGC025
account.api.arrangement.fromToDateBadComboGC025
account.api.arrangement.invalidFromDateGC025
account.api.arrangement.emptyArrangementIdsGC025
account.api.exportBalance.invalidFormatGC025
account.api.exportBalance.exceededLimitGC052
account.balanceHistory.api.invalidTimePeriodGC025
account.api.arrangement.unlinkGC004
account.api.arrangement.withLiveBalance.invalidIdentifiersJsonGC024
product.summary.api.arrangement.noPrivilegeGC004
product.summary.api.legalEntity.notAllowedGC004
arrangements.api.batch.minSizeNotReachedGC025
arrangements.api.no.parent.child.mappingGC201
attribute.not.foundGC025
attribute.not.unmaskableGC025
arrangements.api.notExist.subscriptionGC201
arrangements.api.externalLegalEntity.externalId.SizeGC025
arrangements.api.internalLegalEntity.id.SizeGC025
arrangements.api.legalEntity.relation.SizeGC025
KEY_API_PARSEGC024
arrangement-manager.api.Invalid.aliasGC201
transactions.api.invalidId.arrangementGC201
transactions.api.invalidIds.arrangementGC201
transactions.api.notFound.arrangementGC201
transactions.api.invalidParameters.transactionGC203
transactions.api.invalid.bookingDateGreaterThanGC203
transactions.api.invalid.bookingDateLessThanGC203
transactions.api.notFound.transactionGC203
transactions.api.noPrivilege.transactionGC203
transactions.api.noPrivilege.arrangementGC002
transactions.api.invalidBody.accessGroupGC002
transactions.api.notFound.userGC203
transactions.api.noPrivilege.userGC002
api.Size.arrangementIdsGC025
transactions.api.size.transactionGC203
transactions.api.request.attribute.bad.valueGC203
transactions.api.invalidGC203
transactions.api.get.defaultValues.bad.paramGC203
pfm.api.invalid.dateGC203
pfm.api.invalid.range.dateGC203
pfm.api.invalid.creditDebitIndicatorGC203
pfm.api.invalid.intervalDurationGC203
pfm.api.invalid.forecastGC203
transactions.api.io.error.writing.fileGC203
pfm.api.invalid.arrangementIdsGC201
transactions.api.invalid.exportTypeGC203
transactions.api.state.definition.errorGC203
transaction.api.export.ofx.booked.balanceGC203
transactions.api.checkImageUnavailable.transactionGC203
transaction.api.export.general.errorGC203
transaction.api.notFound.stateGC203
transactions.api.invalid.amountGC203
transactions.api.invalid.descriptionGC203
transactions.api.invalid.bookingDateGC203
transactions.api.notSupported.bookingDateGC203
REQUEST_ERRORGC025
common.api.consent.INVALID_CONSENTGC704
common.api.consent.INTERNAL_ERRORGC027
common.api.consent.FORBIDDENGC004
common.api.consent.INVALID_PARAMETER_VALUEGC007
common.api.consent.TOKEN_MISMATCH_ERRORGC705
common.api.consent.INVALID_CONSENT_STATUSGC704
common.api.consent.CONSENT_PAYMENT_NOT_FOUNDGC706
common.api.consent.CONSENT_PAYMENT_ID_MISMATCHGC707
common.api.consent.CONSENT_SCHEME_MISMATCHGC708
For a complete list of Grand Central error codes and their descriptions, see Status codes, errors, and responses.