Wires

Use this endpoint to initiate Wire Transfers.

Operations

Create Wire

Request

Initiates a Wire Transfer. Wires can only be sent to accounts created and verified via Create Counterparty. Initiating outgoing wire transfers isn’t available by default and must be enabled — please contact your Jiko point of contact to learn more.

Note: description is sent to the beneficiary's bank with the wire, so it may only contain printable ASCII characters (letters, digits, space and standard punctuation), the character set the Fedwire Funds Service accepts. Any other character, such as an accented letter, a line break or a tab, is rejected with a 422 InputValidationError.

When implementing our Wire Transfer entry screens in your application's UI, you must include the following instructions for your end-users: “By using this service, you hereby acknowledge that sending wires to third parties presents an increased risk of fraud, and that as per the terms of your Commercial Bank Account Agreement (the "Agreement"), you agree that our security measures are commercially reasonable methods of providing security against unauthorized Funds Transfers, and that you shall be bound by any request for a Funds Transfer received by the Bank, whether or not authorized, issued in your name and accepted by the Bank in compliance with the security measures.”

Security

HTTPBearer

Path

account_idstring, (uuid)(Account Id)required

x-jiko-idempotencystring, (uuid)(X-Jiko-Idempotency)required

A UUID you generate to identify this request. Reusing a value that was already sent is rejected as a duplicate request.

x-jiko-signaturestring(X-Jiko-Signature)required

Base64-encoded HMAC-SHA256 hash of x-jiko-idempotency + request pathname + body, keyed with your shared secret. See Authentication for the full algorithm and a code sample.

Bodyapplication/jsonrequired

counterparty_idstring, (uuid)(Counterparty Id)required

amount_usdcinteger(Amount Usdc)required

The amount, in USD cents.

created_bystring(Created By)required

A string identifying the wire transfer originator.

descriptionstring or null(Description)

Any of:

A description of the transfer, visible on statements.

<= 100 characters

string

wire_idstring or null(Wire Id)

Any of:

The ID for this wire transfer, auto-generated if not provided.

string (uuid)

curl -i -X POST \
  'https://your-partner-name.sandbox-api.jikoservices.com/api/v1/jiko-accounts/{account_id}/wires/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string' \
  -d '{
    "counterparty_id": "fd38dae9-b300-4017-a630-101c4279eafd",
    "amount_usdc": 0,
    "created_by": "string",
    "description": "string",
    "wire_id": "ee348d7b-d167-4ca8-80b9-4841e2d7e35c"
  }'

Responses

Successful Response

Headers

Locationstring

The URL of the created wire.

Response

No content