Skip to main content
POST
Send a payment

Authorizations

Authorization
string
header
required

An access token (at_test_… or at_live_…) from POST https://idp.talescria.com/oauth/token.

Headers

Idempotency-Key
string
required

A unique key for this operation. Send the same key when you retry it. Kept for 24 hours.

Required string length: 8 - 255
Pattern: ^[A-Za-z0-9_\-:.]+$

Body

application/json
fromAccountId
string
required

The account to pay from, as returned by List accounts.

recipientId
string
required
destinationId
string
required

One of the recipient's destinations. Retrieve a recipient to list them.

minorUnits
string
required

Integer minor units, as a string. Not a number: JSON numbers lose precision above 2^53, and an amount is the last thing that should discover that.

Pattern: ^\d+$
Example:

"125000"

currency
string
required

Upper-cased for you.

narration
string

What the recipient sees on their statement, where the rail carries one.

Maximum string length: 200
reason
string

Why they're being paid: one of List payment reasons. Some destinations require it.

Maximum string length: 64
Example:

"goods_purchased"

idempotencyKey
string

Optional with an API key: the Idempotency-Key header is used when you leave it out.

Maximum string length: 200
fxQuoteId
string

An FX quote, required when the destination receives a currency the account doesn't hold. minorUnits must equal the quote's amountFromMinorUnits.

Response

This idempotencyKey already named a transfer. Returned, not sent again.

transfer
object