Account Funding

This API is only available to beta users.

Get funding sources

get

Query parameters

typestring · enumRequired

Type of funding source to search

Example: PISPPossible values:

currencystring · enumRequired

Currency supported by the funding source

Example: GBPPossible values:

Header parameters

authorizationstringOptional

Authorization header containing your API Token

x-alg-noncestringOptional

Nonce used to generate the payload signature

x-alg-signaturestringOptional

Payload signature

datestringOptional

Date of the request un UTC/GMT

Responses

200

Returns the list of sources

application/json

idstring · uuidRequired

Unique identifier of the funding source

Example: f49281c0-0840-55bd-95b3-3b46d1d0e9f1

namestringRequired

Display name of the funding source

Example: John Doe

typestring · enumRequired

Type of funding source

Example: PISPPossible values:

logostring · nullableOptional

Logo URL representing the funding source

Example: https://app-static.algbra.com/banklogo/mock-payments-gb-redirect.png

403

Forbidden

application/json

get

/v1/partner/payments/funding/sources

HTTPcURLJavaScriptPython

GET /v1/partner/payments/funding/sources?type=PISP&currency=AFN HTTP/1.1
Accept: */*

[
  {
    "id": "f49281c0-0840-55bd-95b3-3b46d1d0e9f1",
    "name": "John Doe",
    "type": "PISP",
    "logo": "https://app-static.algbra.com/banklogo/mock-payments-gb-redirect.png"
  }
]

Initiate funding

post

Path parameters

customerIdstringRequired

Header parameters

authorizationstringOptional

Authorization header containing your API Token

x-alg-noncestringOptional

Nonce used to generate the payload signature

x-alg-signaturestringOptional

Payload signature

datestringOptional

Date of the request un UTC/GMT

Body

application/json

fundingSourceTypestring · enumRequired

Type of funding source.

Example: PISPPossible values:

fundingSourceProviderIdstring · uuidRequired

ID of the funding source provider.

Example: f49281c0-0840-55bd-95b3-3b46d1d0e9f1

destinationAccountIdstring · uuidRequired

ID of the destination account to fund.

Example: e0cab2dd-739f-43de-b131-3e423e935bf1

externalReferencestring · uuidRequired

Reference identifier provided by partner.

Example: ae588135-0391-42a8-a4e4-e8e7645fa707

amountnumberRequired

Amount of the funding in minor units (e.g., for £1.29 enter 129).

Example: 129

idempotencyKeystring · uuidRequired

Idempotency key to prevent duplicate funding operations.

Example: 1483d25d-3f00-4d39-90ce-2379a130becd

Responses

200

Returns payment details and redirect url

application/json

paymentIdstring · uuidRequired

Unique identifier of the initiated payment

Example: 1489dd60-aa06-48a6-a267-e7d4a9a84200

redirectUrlstringRequired

URL to redirect the user to complete the funding process

Example: https://openbanking.examplebank.com/login/46c7a72b-ee3f-4b57-a143-7633ab76732d#token=xyz

400

Input validation error

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable entity

application/json

post

/v1/partner/payments/funding/customers/{customerId}/initiate

HTTPcURLJavaScriptPython

POST /v1/partner/payments/funding/customers/{customerId}/initiate HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 283

{
  "fundingSourceType": "PISP",
  "fundingSourceProviderId": "f49281c0-0840-55bd-95b3-3b46d1d0e9f1",
  "destinationAccountId": "e0cab2dd-739f-43de-b131-3e423e935bf1",
  "externalReference": "ae588135-0391-42a8-a4e4-e8e7645fa707",
  "amount": 129,
  "idempotencyKey": "1483d25d-3f00-4d39-90ce-2379a130becd"
}

{
  "paymentId": "1489dd60-aa06-48a6-a267-e7d4a9a84200",
  "transaction": {
    "transactionId": "68c2a19131a3b726fe47fdda",
    "uniqueToken": "1489dd60-aa06-48a6-a267-e7d4a9a84200",
    "origin": "TRANSFER",
    "state": "COMPLETED",
    "category": [
      "TRANSFERS"
    ],
    "impactType": "CREDIT",
    "customerId": "a2b9649e-df7f-4349-adff-1c57283fef10",
    "amount": 129,
    "currencyCode": "GBP",
    "description": "Sent from Algbra",
    "exchangeRate": "1.0",
    "exchangeCurrencyCode": "GBP",
    "sourceCounterparty": {
      "type": "PERSONAL",
      "details": {
        "firstName": "John",
        "lastName": "Doe"
      },
      "accountCurrency": "GBP",
      "accountReferenceType": "UK_ACCOUNT",
      "accountReference": {
        "type": "UK_ACCOUNT",
        "sortCode": "010102",
        "accountNumber": "12345678"
      }
    },
    "destinationCounterparty": {
      "type": "PERSONAL",
      "details": {
        "firstName": "John",
        "lastName": "Doe"
      },
      "accountCurrency": "GBP",
      "accountReferenceType": "UK_ACCOUNT",
      "accountReference": {
        "type": "UK_ACCOUNT",
        "sortCode": "010102",
        "accountNumber": "12345678"
      }
    },
    "transactionDate": "2025-01-01T10:32:01.162Z",
    "cardMetadata": {
      "phase": "AUTHORIZATION",
      "type": "CARD_PAYMENT",
      "cardToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
      "transactionToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
      "eventToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
      "lastDigits": "1234",
      "scheme": {
        "network": "MasterCard",
        "binPrefix": "5432",
        "referenceId": "ref123"
      },
      "cardAcceptor": {
        "mcc": "5411",
        "name": "Supermarket",
        "city": "London",
        "country": "GB"
      },
      "pos": {
        "cardPresent": true,
        "pinPresent": false,
        "terminalId": "TERM001"
      },
      "merchant": {
        "name": "Tesco",
        "summary": "Hyper-Supermarket",
        "imageUrl": "https://s3.eu-central-1.amazonaws.com/files.node-prod.dateio.cz/m/538VqZ4gn33tVJJWEYa8d3/l",
        "location": {
          "latitude": 51.46358,
          "longitude": -0.1861
        }
      }
    },
    "transferMetadata": {
      "rails": "FASTER_PAYMENTS",
      "transactionProgress": [
        {
          "event": "COMPLETED",
          "date": "2025-01-01T10:16:49.621Z"
        }
      ],
      "fundingSourceProvider": {
        "id": "f49281c0-0840-55bd-95b3-3b46d1d0e9f1",
        "name": "John Doe",
        "type": "PISP",
        "logo": "https://app-static.algbra.com/banklogo/mock-payments-gb-redirect.png"
      }
    }
  },
  "redirectUrl": "https://openbanking.examplebank.com/login/46c7a72b-ee3f-4b57-a143-7633ab76732d#token=xyz"
}