The POST /payment_methods call allows your platform to create 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.
Api-Version required | string Example: 3.0 |
Content-Type required | stringapplication/json Example: application/json |
Unique-Key | string |
WePay-Risk-Token | string This header is required when tokenizing Payment Methods, Legal Entities, and Payout Methods when the tokenization JS library is not being used. |
Client-IP | string This header is required when tokenizing Payment Methods, Legal Entities, and Payout Methods when the tokenization JS library is not being used. |
type required | string Type of payment method.
| ||||||
object Credit card payment method information for Apple Pay. | |||||||
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. | |||||||
encoded_payment_method | string [ 1 .. 2048 ] characters Encoded payment data. Currently is used for POS payment tokens but in future may be used for other types of encoded payment information | ||||||
object Credit card payment method information for Google Pay. | |||||||
object Raw bank account information. | |||||||
object A Plaid processor token to make Plaid API calls. | |||||||
Array of objects or null Any rbit data your platform chooses to attach to this resource. The rbit data must be key-value pairs and can be an array of rbit objects. | |||||||
object A previously created token. Note: Using tokens to pass highly-sensitive data directly to WePay may help your platform avoid certain compliance and regulatory overhead. Learn more about tokens here. |
INVALID_PARAMS, MERCHANT_ACCOUNT_CANNOT_ACCEPT_PAYMENTS
NOT_AUTHORIZED
UNEXPECTED_ERROR
{- "type": "plaid_processor_token",
- "plaid_processor_token": {
- "processor_token": "processor-sandbox-0asd1-a92nc",
- "plaid_account_id": "vzeNDwK7KQIm4yEog683uElbp9GRLEFXGK98D",
- "account_holder": {
- "holder_name": "John Matthew Li",
- "email": "ellard.li+test@wepay.com",
- "phone": {
- "country_code": "1",
- "phone_number": "4159922353"
}, - "address": {
- "postal_code": "94122",
- "country": "US"
}
}
}
}
{- "create_time": 1512429148,
- "credit_card": {
- "auto_update": false,
- "backing_display_name": null,
- "bin": "549619",
- "card_brand": "mastercard",
- "card_entry_type": "card_keyed",
- "card_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
}
}, - "display_name": "MasterCard xxxxxx4769",
- "expiration_month": 4,
- "expiration_year": 2020,
- "last_four": "4769",
- "virtual_terminal_mode": null,
- "card_on_file": false,
- "recurring": false,
- "cvv_provided": true,
- "card_funding": "credit",
- "bin_details": {
- "is_prepaid": false
}
}, - "custom_data": null,
- "id": "00000000-6363-0000-0000-0000cd225fe1",
- "owner": {
- "id": "171845",
- "path": null,
- "resource": "applications"
}, - "path": "/payment_methods/00000000-6363-0000-0000-0000cd225fe1",
- "resource": "payment_methods",
- "status": "verified",
- "type": "credit_card",
- "api_version": "3.0"
}