API Reference

Create Transfer With Recipient Id

Use this API to initiate a transfer using an existing recipient by providing the recipientId. you do not need to provide all the recipient's account and address details—these will be retrieved using the recipientId. To understand more about the individual payment rails. We can do these payments :

  • INTERNAL
  • ACH
  • SAMEDAYACH
  • External Card Pull
  • External Card Push
  • WIRE
  • International WIRE (SWIFT)

During the lifecycle of a transfer, its status may undergo changes. Refer to the Transfer Status page at Transfer Status for detailed descriptions associated with each status.

For Payment Rails such as Domestic and Internal WIRE, the recipient address is mandatory. To pass the recipient address, one needs to pass the stateCode, countryCode. This information can be viewed at US State Codes

Please check the below BODY PARAMS section for different types of Transfers.

**Note1: All the payment API's have the endpoint: /payments **

**Note2: The recipient's client must belong to the same originator account as the payment. If the recipient's client is not associated with the originator account, the system will return an error: 'Payment cannot be processed because the recipient ID does not belong to the originator account **

FunctionWebhook
Create TransferCreate Transfer
Submit TransferSubmit Transfer
Force Submit TransferForce Submit Transfer
Create and Submit TransferCreate and Submit Transfer
Log in to see full request history
Body Params
string
required
Defaults to CREDIT

Specifying the type of payment during the transfer. Pattern: CREDIT/DEBIT is allowed. Example: CREDIT

string

Specifies the payment rail to be used for the transfer. Example: ACH

number
required
Defaults to 10

The amount to be transferred in USD. Pattern: Maximum amount is defined by the transfer limits configured. Example: 10

originator
object
required

The details of the originator for ACH transfer.

recipient
object
required

Recipient details object. Use this when creating a transfer using an existing recipient. Provide the recipientId of the saved recipient.

string

Optional reference or description for the transaction. Max Length of 140 characters Example: transferring to amy

string

Unique identifier for tracking the transaction. Maximum length: 100 characters. Example: 6B56xh4DxD5gmYzEjpuZn11dfsdfsd1f

Responses

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json