Create a new transaction

post

https://localhost/external-balance/transactions

Authorise a new non-scheme (non-card) transaction

Body Params

transactionId

uuid

required

authorisationTransactionType

string

enum

required

Allowed:

accountId

uuid

required

amount

object

required

Transaction amount. Positive when crediting customer account and negative when debiting.

counterpartDetails

object | null

description

string

reference

string

account

object | null

Account context at the time of the transaction.

customer

object | null

Set when the account holder is a customer, or when a group account transaction was triggered by one.

transactionTimeUtc

date-time

DateTime in UTC format when the transaction occurred

Headers

Shaype-Version

string

Version of the API used to format the payload

Shaype-Trace-Id

string

Unique identifier for correlation between systems

Shaype-Idempotency-Key

string

Unique request identifier

Shaype-Timestamp

string

RFC-3339 date and time of request

Shaype-Signature

string

Signature hash of the request body with the shared secret

Shaype-Key-Id

string

Unique identifier of the key used to verify the signature

Responses

200

500

Internal error

470The request contained valid data and was understood by the server, but the server is refusing action due to internal validity, status or limit checks or similar failure of request to the 3rd party necessary to fulfil client request.