Get a payment method

get/payment_methods/{id}

The GET /payment_methods/{id} call allows your platform to look up a specific 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

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

header Parameters
Api-Version
required
string
Example: 3.0
Unique-Key
string
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.

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

403

NOT_AUTHORIZED

500

UNEXPECTED_ERROR

Request samples
Response samples
application/json
{
  • "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
    },
  • "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"
}