Create payment method

curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/payment-methods \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "ach",
  "asset": "usd",
  "ach": {
    "routingNumber": "123456789",
    "accountNumber": "0987654321",
    "accountType": "checking",
    "name": "My Checking Account"
  }
}'

{
  "id": "8e03978e-40d5-43e8-bc93-6894a57f9324",
  "type": "ach",
  "asset": "usd",
  "name": "ALLY BANK ******1234",
  "verified": true,
  "allowDeposit": true,
  "allowWithdraw": false,
  "allowOutboundPayment": true,
  "limits": [
    {
      "remaining": {
        "amount": "900.00",
        "asset": "usd"
      },
      "used": {
        "amount": "100.00",
        "asset": "usd"
      },
      "total": {
        "amount": "1000.00",
        "asset": "usd"
      },
      "limitPeriod": "daily",
      "description": "Daily ACH transfer limit."
    }
  ]
}

POST

payment-methods

curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/payment-methods \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "ach",
  "asset": "usd",
  "ach": {
    "routingNumber": "123456789",
    "accountNumber": "0987654321",
    "accountType": "checking",
    "name": "My Checking Account"
  }
}'

{
  "id": "8e03978e-40d5-43e8-bc93-6894a57f9324",
  "type": "ach",
  "asset": "usd",
  "name": "ALLY BANK ******1234",
  "verified": true,
  "allowDeposit": true,
  "allowWithdraw": false,
  "allowOutboundPayment": true,
  "limits": [
    {
      "remaining": {
        "amount": "900.00",
        "asset": "usd"
      },
      "used": {
        "amount": "100.00",
        "asset": "usd"
      },
      "total": {
        "amount": "1000.00",
        "asset": "usd"
      },
      "limitPeriod": "daily",
      "description": "Daily ACH transfer limit."
    }
  ]
}

Authorizations

Authorization

string

header

required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Body

application/json

ACH Payment Method
Fedwire Payment Method

type

enum<string>

required

Payment method type.

Available options:

ach

Example:

"ach"

asset

string

required

The asset symbol for the payment method.

Example:

"usd"

ach

object

required

ACH payment method details.

Show child attributes

ach.routingNumber

string

required

The bank routing number.

Example:

"123456789"

ach.accountNumber

string

required

The bank account number.

Example:

"0987654321"

ach.accountType

enum<string>

The type of bank account.

Available options:

checking,

savings

Example:

"checking"

ach.name

string

Display name for the payment method.

Example:

"My Checking Account"

Example:

{
  "routingNumber": "123456789",
  "accountNumber": "0987654321",
  "accountType": "checking",
  "name": "My Checking Account"
}

Response

The created payment method.

string

required

The identifier of the payment method.

Example:

"8e03978e-40d5-43e8-bc93-6894a57f9324"

type

enum<string>

required

The type of payment method.

Payment methods represent different rails for moving money. Common values include:

ach - Automated Clearing House transfers for US bank accounts
fedwire - Federal Reserve Wire Network transfers for US bank accounts

Available options:

ach,

fedwire

Example:

"ach"

asset

string

required

Asset symbol for the payment method.

Example:

"usd"

name

string

Name for the payment method.

Example:

"ALLY BANK ******1234"

verified

boolean

The verified status of the payment method.

Example:

true

allowDeposit

boolean

Whether or not this payment method can perform deposits.

Example:

true

allowWithdraw

boolean

Whether or not this payment method can perform withdrawals.

Example:

false

allowOutboundPayment

boolean

Whether or not this payment method can perform outbound payments.

Example:

true

limits

object[]

List of ACH limits for the payment method.

The limit for the payment method.

Show child attributes

remaining

object

The remaining amount available in the limit.

Show child attributes

remaining.amount

string

required

Numeric value representing the amount.

Example:

"1000.00"

remaining.asset

string

required

Asset symbol (currency code) for the amount.

Example:

"usd"

Example:

{ "amount": "1000.00", "asset": "usd" }

used

object

The amount already used from the limit.

Show child attributes

used.amount

string

required

Numeric value representing the amount.

Example:

"500.00"

used.asset

string

required

Asset symbol (currency code) for the amount.

Example:

"usd"

Example:

{ "amount": "500.00", "asset": "usd" }

total

object

The total limit amount.

Show child attributes

total.amount

string

required

Numeric value representing the amount.

Example:

"1500.00"

total.asset

string

required

Asset symbol (currency code) for the amount.

Example:

"usd"

Example:

{ "amount": "1500.00", "asset": "usd" }

limitPeriod

enum<string>

Period of the limit.

unknown The period is unknown.
daily The limit is daily.
weekly The limit is weekly.
monthly The limit is monthly.
biweekly The limit is bi-weekly.

Available options:

unknown,

daily,

weekly,

monthly,

biweekly

Example:

"daily"

description

string

The description of the limit.

Example:

"Daily ACH transfer limit."

Example:

[
  {
    "remaining": { "amount": "900.00", "asset": "usd" },
    "used": { "amount": "100.00", "asset": "usd" },
    "total": { "amount": "1000.00", "asset": "usd" },
    "limitPeriod": "daily",
    "description": "Daily ACH transfer limit."
  }
]

List payment methods

Transfers

⌘I

CDP PAYMENTS API

REST API

Authorizations

Body

Response