A Collect via Wire transaction allows you to pull funds from an external bank account into a Passport account using the Wire network. Unlike other payment methods, Wire transfers offer faster settlement and are best suited for high-value, time-sensitive transactions between business accounts.

Passport supports two source types for Wire Collect transactions:

• External Account (Own Account): Pull funds from a pre-linked external bank account into a Passport account.
• One-Time: Pull funds from a third-party bank account by providing the account details directly at the time of the transaction.

Wire Collect transactions are processed as Wire Drawdowns — a reverse wire initiated by the fund recipient rather than the sender. This means the recipient (you) pulls funds from the payer's account with their authorization, rather than the payer pushing funds to you. Wire Drawdowns are available to Business Customers only.

How it Works

Step 1: Initiate the Collect Transaction

To create a Collect via Wire, make a POST request to the /v1/customer/id/{id}/transaction endpoint with the required parameters. The source object in your request determines which Wire Collect type is being initiated.

Source Types

Passport supports the following source types for Wire Collect transactions. Select the one that matches where the funds are being pulled from.

1. Collect from External Account (Own Account): Use this when pulling funds from a bank account that has already been linked to Passport as an External Account. Only Business Customers with a CORPORATE account holder type are supported for Wire Collect. Pass the pre-linked External Account identifier in the source object:

   Parameter	Required	Description
   source.externalAccount.id	✓	Unique identifier of the External Account assigned by Passport.
   destination.externalAccount.id	✓	Unique identifier of your Passport account where funds will be credited.

2. Collect from a One-Time Source: Use this when pulling funds from a third-party bank account that is not pre-linked to Passport. The account details are provided directly in the transaction request. Only Business Customers can initiate a One-Time Wire Collect. Pass the account details directly in the source object:

   Parameter	Required	Description
   source.externalAccount.accountNumber	✓	The bank account number to be debited.
   source.externalAccount.routingNumber	✓	The 9-digit ABA routing number of the account.
   source.externalAccount.wireRoutingNumber	✓	The wire-specific routing number of the account.
   source.externalAccount.holderName	✓	Name of the bank account holder as it appears on bank records.
   source.externalAccount.holderType		Type of account holder. Possible values: CONSUMER, CORPORATE.
   source.externalAccount.type		Type of bank account. Possible values: SAVING, CHECKING.

Processing Details

The processingDetail object carries additional processing instructions for your Wire Collect transaction. While optional as a whole, certain fields within it may be required depending on your Program Manager configuration.

Step 2: Check the Outcome

For every successfully created Collect transaction, store the id/ externalId - The unique Transaction ID assigned by Passport or your own reference ID, if provided at the time of creation. Once the transaction is submitted, our system performs a series of validations before processing the request. These validations check for:

1. Missing or invalid required fields
2. Incorrect parameter formats or values
3. Program Manager configuration or permission issues

If any validation fails, the request is rejected immediately and an error response is returned. You must correct the issue and resubmit the request.

If all validations pass, the transaction is submitted for processing. You can determine the outcome by retrieving the transaction via GET /v1/customer/id/{id}/transaction/id/{id} or by subscribing to the Transaction webhook. Check the status field in the response to understand the current state of the transaction.

Transaction Statuses

The table below describes the possible statuses of a Wire Collect transaction and the reasons associated with each.

Best Practices

See Also