Skip to content

Pay Third-parties using Wires or Swift

This section covers the core functionality for initiating third-party outgoing payments using the Wire or Swift payment rails. Another section covers the JikoNet payment rail.

As described below, third-parties can also debit your Jiko pockets:

Payment InitiatorDescriptionPayment Rails
Your companySubmit, approve and release payments in Jiko.Wire, Swift, JikoNet
Your counterpartyAllow your counterparties to initiate an ACH pull to debit your Jiko pocket.ACH

Section in progress: see Third-party Payment Initiation & Management using JikoNet.

Create a Counterparty

Business Goal

To initiate a transfer, you must first create the counterparty. You are responsible for gathering the necessary account details (example: routing number of BIC code, account number...) directly from the counterparty outside of the Jiko system.

Business Workflow Example

Customer systems:

  1. Gather from the counterparty its account details.

  2. Send to Jiko a counterparty creation request.

  3. Receive from Jiko the unique Jiko ID assigned to this counterparty.

  4. Associate this Jiko Id with the counterparty in payment origination systems.

Relevant API Endpoints

StepPurposeJiko API Endpoints
1Create a new payment beneficiary.POST /api/v2/counterparties/

Illustration

Submit a Wire/Swift Transfer request

Relevant API Endpoints

StepPurposeJiko API Endpoints
1Create a new transfer request.POST /api/v1/transfer-requests/

Cancel a Wire/Swift Transfer request

See Cancel a JikoNet Transfer request.

Approve a Wire/Swift Transfer request

See Approve a JikoNet Transfer request.

Retrieve the Status of a Wire/Swift Transfer request

See Retrieve the status of a JikoNet transfer request.

Receive notifications of changes in the payment status

See Receive Event Notifications (Webhooks).

List historical payments

See List historical JikoNet payments.