Create a new payout entity
| Time | Status | User Agent | |
|---|---|---|---|
| Make a request to see history. |
URL Expired
The URL for this request expired after 30 days.
Create a new associated entity
payout_entity_id
string^(?!can_).*$
The ID to be associated with the payout entity for future requests. If not provided on payout entity creation, Canopy will generate this field.
payout_entity_type
string
enum
required
Type of associated entity
Allowed:merchant lender sponsor organization clearing
payout_entity_name
string
required
Entity's name.
external_fields
array,null | object,null
parent_payout_entity_id
string
A Canopy-generated ID for the parent of this associated entity to establish a parent-child relationship.
bank_account_number
string
Account number of the bank account for payment distributions.
bank_routing_number
string
The 9 digit routing number of the bank account for payment distributions. The final digit must pass check digit validation.
bank_account_type
string
enum
The type of bank account being stored for the payout entity.
Allowed:CHECKING SAVINGS GL
irs_tin
string
The IRS tax identification number of the entity.
payment_processor_config
object | null
The configuration for different payment processors.
Response Codes
200 New Associated Entity Created
401 Unauthorized.
403 Forbidden.
404 Customer not found
422 Invalid input
429 Too many requests.
default Unexpected Error.
Command Example
curl --request POST \
--url https://contact/%20sales%20to%20enable%20your%20sandbox/payout_entities \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{\n "payout_entity_type": "merchant"\n}'
Response Example
200