v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
BACS

Send BACS direct credit outbound payment [beta]

Send a <a href="https://www.moderntreasury.com/learn/what-is-bacs" target="_blank">Banking Automated Clearing System</a> (BACS) direct credit outbound payment.

BACS is a UK service that facilitates electronic money transfers between banks within a 3-day settlement cycle— Day 1 (submission), Day 2 (processing), and Day 3 (clearing/credit).

There are two main concepts in BACS:

  1. Direct credit - A company can use this format to pay their employees.

  2. Direct debit - When an electricity company charges their costumers recurrently it will have a subscription (called mandates). When a mandate is generated monthly, the originator creates a charge. When this charge comes to the client here at Pismo. Pismo then debits the customer account.

Both of these methods generate a cashin, cashout, and return.

For more information, refer to the BACS guide.

Notes:

post/v1/payments/bacs/directcredit/out

Headers

Authorizationstring required

Account token - token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message

Idempotency-keystring required

A UUID (without hyphens) to ensure the operation remains idempotent, allowing for operation repetition without causing unintended effects or duplication. Identifies the transaction on future events.

Request body

referencestring required

Remittance reference.

Example request

{
  "reference": "Weekly money for Mom",
  "creditor_account": {
    "name": "Len Lease",
    "scheme_name": "iban",
    "identification": "AA00AAA000000000000000"
  },
  "currency": {
    "amount": 600,
    "code": "GBP"
  }
}

Response

Response Body

idstring

Client-generated transaction identifier. This is the idempotency key UUID passed in the Send direct credit outbound payment endpoint.

status'CREATED' | 'PROCESSING' | 'SETTLED' | 'CANCELLED' | 'HOLD'
  • CREATED - Payment has been created and is pending processing
  • PROCESSING - P2P balance was impacted and waiting for provider confirmation. For cashin, the transaction means the money will be credited on the next Working Day
  • SETTLED - Transaction completed processing and is settled
  • CANCELLED - Something went wrong and the transaction is cancelled. Refer to reason for more details
  • HOLD - The payment is on hold, pending further review

Example response

{
  "id": "1374f841568e4ff4b363b023c170ecdr",
  "status": "PROCESSING"
}