WePay logo
      Nothing Found

Get a payout method

get/payout_methods/{id}

The GET /payout_methods/{id} call allows your platform to look up a single payout method. Payout methods represent payout targets, such as bank accounts.

SecurityappIdAuth and appTokenAuth
Request
path Parameters
id
required
string [ 1 .. 255 ] characters

The ID of the payout method, generated by WePay when the payout method is created.

header Parameters
Api-Version
required
string
Example: 3.0
Unique-Key
string
Responses
200
Response Schema: application/json
resource
required
string

Helps organize information by identifying the resource type of the object data.

Value: Description
payout_methods
id
required
string

The ID of the payout method, generated by WePay when the payout method is created.

path
required
string

The path of resource and resource ID.

api_version
string
create_time
integer <int64> >= 0

The time (in UNIX) when the payout method was created.

object or null

Any custom data your platform chooses to attach to this resource. The custom data must be key-value pairs and not contain any personally identifiable information (PII) or payment card (PCI) data.

nickname
string [ 1 .. 64 ] characters

The nickname of the payout method.

object

Details the owner resource and owner path.

object

Define how to payout a merchant based in the US via paper check. Note: Paper checks require permission from WePay, and only US-based merchants can receive payouts via paper check. Reach out to your integration team for further information.

object

Contains parameters relevant to the payout method.

object

Contains parameters relevant to the payout method.

object

Contains parameters relevant to the payout method.

status
string

Describes the status of the specific payout method.

Enum: Description
active

This payout method is active, so it can be queried via the APIs and used as a merchant's payout method.

disabled

Due to three (3) failed attempts to send payouts to this payout method, it has been disabled. Find more information on the failed payouts by examining the failure_reason object of the payout resource. Note that disabled payout methods cannot be queried via the APIs or used as a merchant's payout method.

… 1 more
type
string

Possible values: payout_bank_ca, payout_bank_us and payout_bank_gb. Note: The paper_check option requires permission from WePay to use. Reach out to your integration team for assistance.

Enum: Description
payout_bank_ca

Bank account in Canada.

payout_bank_gb

Bank account in the UK (not currently supported).

… 2 more
400

INVALID_PARAMS

403

NOT_AUTHORIZED

500

UNEXPECTED_ERROR

Request samples 
Response samples 
application/json
{
  • "create_time": 1480700534,
  • "custom_data": null,
  • "id": "0102b1c6-2bc7-448a-aa1d-076b1637547c",
  • "nickname": "Foo Bar Bank",
  • "owner": {
    • "id": "42d2c2f1-5aeb-4929-944f-e220b4c9425b",
    • "path": "/legal_entities/42d2c2f1-5aeb-4929-944f-e220b4c9425b",
    • "resource": "legal_entities"
    },
  • "path": "/payout_methods/0102b1c6-2bc7-448a-aa1d-076b1637547c",
  • "payout_bank_us": {
    • "account_type": "checking",
    • "last_four": "6998"
    },
  • "resource": "payout_methods",
  • "status": "active",
  • "type": "payout_bank_us",
  • "api_version": "3.0"
}