WePay logo
      Nothing Found

Verify a payout method

post/payout_methods/{id}/verify_bank_deposits

The POST /payout_methods/{id}/verify_bank_deposits call allows your platform to verify a payout method. Payout methods represent payout targets, such as bank accounts.

SecurityappIdAuth and appTokenAuth
Request
path Parameters
id
required
string [ 1 .. 255 ] characters
header Parameters
Api-Version
required
string
Example: 3.0
Content-Type
required
stringapplication/json
Example: application/json
Unique-Key
string
Request Body schema: application/json
microdeposits
required
Array of integers = 2 items

The list of microdeposits that we have sent to the payee's bank account.

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 payout method. Possible values include: active, verified, unverified, pending_verification, disabled, and deleted

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.

… 4 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, PAYOUT_METHOD_CANNOT_BE_VERIFIED

403

NOT_AUTHORIZED

500

UNEXPECTED_ERROR

Request samples
application/json
{
  • "microdeposits": [
    • 7,
    • 8
    ]
}
Response samples
application/json
{
  • "id": "00000000-0000-0000-0000-000000000008",
  • "resource": "payout_methods",
  • "path": "/payout_methods/00000000-0000-0000-0000-000000000008",
  • "owner": {
    • "id": "9cdedade-fadd-ef62-bcca-e5bbe55d3797",
    • "resource": "legal_entities",
    • "path": "/legal_entities/9cdedade-fadd-ef62-bcca-e5bbe55d3797"
    },
  • "create_time": 1672904373,
  • "nickname": "Another bank account US",
  • "type": "payout_bank_us",
  • "status": "verified",
  • "payout_bank_us": {
    • "account_type": "checking",
    • "last_four": "6761"
    },
  • "custom_data": null,
  • "api_version": "3.1"
}