Skip to main content
POST
Store payment profile

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

consumer
integer
required

Consumer account ID.

Body

application/json
address
string
required
Maximum string length: 255
Example:

"123 Main St"

city
string
required
Maximum string length: 255
Example:

"Austin"

state
string
required
Example:

"TX"

zip
string
required
Maximum string length: 10
Example:

"73301"

method
enum<string> | null
required
Available options:
cc,
ach,
null
save_payment_method
boolean
required

Saves the profile for future use when no active saved profile already exists for that method.

is_terms_accepted
boolean
required

Must be true.

basis_theory_response
object
required

Basis Theory token intent payload generated by the frontend tokenization flow. The backend verifies this id and converts it to a token when the profile must be reusable.

first_name
string | null
Maximum string length: 255
last_name
string | null
Maximum string length: 255
account_type
enum<string> | null

Required for ACH profiles.

Available options:
checking,
savings,
null

Response

Payment profile stored.

message
string
required
Examples:

"Payment profile stored."

"Payment setup completed."

"Settlement payment processed."

data
object
required
Last modified on July 19, 2026