Verify a payment method

post/payment_methods/{id}/verify_bank_deposits

The POST /payment_methods/{id}/verify_bank_deposits call allows your platform to verify a payment method. Payment methods represent payment data like credit cards and bank accounts, and allow your platform to charge and accept money from a payer.

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
Responses
200
Response Schema: application/json
id
required
string

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

resource
required
string

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

Value: Description
payment_methods
path
required
string

Path of resource and resource ID.

required
object

Details the owner resource and owner path.

create_time
required
integer <int64> >= 0
type
required
string

Type of payment method. Possible values include: credit_card, payment_bank_us, payment_method_id, encoded_payment_method.

Enum: Description
credit_card

This value is required if the credit_card structure is being sent with raw credit card data.

payment_bank_us

This value is required if the payment_bank_us structure is being sent with the raw bank account data.

… 3 more
status
required
string

Possible values include: deleted, unverified, verification_failed, verified.

Enum: Description
unverified

This payment method has not been verified yet and cannot be used to create payments until the status updates to verified.

verified

This payment method has successfully been verified and can now be used to create payments.

… 2 more
api_version
string
object

Raw credit card information.

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.

object

Raw bank account information.

400

INVALID_PARAMS, PAYMENT_METHOD_CANNOT_BE_VERIFIED

403

NOT_AUTHORIZED

500

UNEXPECTED_ERROR

Request samples
application/json
{
  • "microdeposits": [
    • 10,
    • 55
    ]
}
Response samples
application/json
{
  • "create_time": 1512429148,
  • "custom_data": null,
  • "id": "00000000-6261-5553-0000-000000000dd9",
  • "owner": {
    • "id": "137137",
    • "path": null,
    • "resource": "applications"
    },
  • "path": "/payment_methods/00000000-6261-5553-0000-000000000dd9",
  • "payment_bank_us": {
    • "account_holder": {
      • "address": {
        • "city": "",
        • "country": "US",
        • "line1": "",
        • "line2": "",
        • "postal_code": "94025",
        • "region": ""
        },
      • "email": "example@wepay.com",
      • "holder_name": "John Snow",
      • "phone": {
        • "country_code": null,
        • "phone_number": null,
        • "type": null
        }
      },
    • "account_type": "checking",
    • "last_four": "6789"
    },
  • "resource": "payment_methods",
  • "status": "verified",
  • "type": "payment_bank_us",
  • "api_version": "3.0"
}