Add Payment Method

Add ACH or debit/credit payment method.

POST /v3/paymentMethods/add

Request

The details below help you form your HTTP requests to this endpoint.

Headers

You may need to provide specific headers.

Name	Type	Required	Description
customer-token	string		Customer's authentication token
x-version-override	string		N/A

Body

You must provide a JSON payload.

Name	Type	Required	Description
primary	boolean		N/A
label	string		N/A
ach	object		N/A
ach.routing	string		N/A
ach.account	string		N/A
ach.accountType	string		N/A
token	object		N/A
token.expirationDate	string		N/A
token.cardType	string		N/A
token.lastFour	string		N/A
token.firstSix	string		N/A
token.token	alternatives		N/A
token.billingZip	string		N/A

Response

The details below help you understand the responses you could get from this endpoint.

Samples

Below are samples of responses, with tabs corresponding to returned status code.

201

{
    "data": {}
}

400-11503

{
    "error": {
        "statusCode": 400,
        "code": 11503,
        "message": "Payment method is not primary eligible",
        "data": {}
    }
}

400-11505

{
    "error": {
        "statusCode": 400,
        "code": 11505,
        "message": "Bank is not accepted",
        "data": {}
    }
}

400-11506

{
    "error": {
        "statusCode": 400,
        "code": 11506,
        "message": "Bank requires verification",
        "data": {}
    }
}

Schema

The response's schema is outlined below.

Name	Type	Required	Description
data	object		N/A