Update External Account

post

https://sandbox-api.prioritycommerce.com/v1/passport/v1/customer/{parentIdType}/{customerId}/externalAccount/{idType}/{id}

Update details of an existing external account.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

parentIdType

string

enum

required

Identifier type for the customer. Use 'id' for the Passport-assigned ID or 'externalId' for the program manager-assigned ID.

Allowed:

customerId

string

required

The customer identifier value, corresponding to the selected parentIdType.

idType

string

enum

required

Identifier type for the external account. Use 'id' for the Passport-assigned ID or 'externalId' for the program manager-assigned ID.

Allowed:

string

required

The external account identifier value, corresponding to the selected idType.

Body Params

Details required to update the external account.

externalId

string

Reference ID assigned by the program manager.

comment

string

Comment passed by the user.

linkedDocument

array of objects

Authorization documents linked to the external account.

linkedDocument

accountNumber

string

The bank account number.

holderPhone

number

Phone number of the bank account holder.

holderAddress

object

Address of the bank account holder.

holderType

string

enum

Holder type of the account.

Allowed:

purpose

string

Purpose of adding the external account.

type

string

enum

Type of the account.

Allowed:

wireRoutingNumber

string

9-digit routing number used for Wire transactions.

routingNumber

string

9-digit routing number used for ACH transactions.

holderName

string

Name of the bank account holder as it appears on bank records.

validateAccount

array of objects

Validate the account details using a validation method.

validateAccount

prenote

string

enum

Validate the account details using prenote.

Allowed:

microDeposit

string

enum

Validate the account details using micro deposit.

Allowed:

Headers

PromiseMode

string

enum

required

Controls response timing. NEVER returns an immediate response; ALWAYS defers processing.

Allowed:

Responses

202

The request has been accepted for processing. Expected when PromiseMode is ALWAYS.

204

The external account was updated successfully. No content returned.

400

The request could not be processed due to invalid or missing parameters.

401

The request lacks valid authentication credentials. Verify the API key and authorization header.

403

The authenticated user does not have permission to perform this operation.

500

An unexpected error occurred on the Passport server while processing the request.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

299The external account was updated successfully, but the action may impact transacting. Check the warning details.