Skip to main content
POST
/
customers
/
{id}
/
payment-methods
Create payment method
curl --request POST \
  --url https://api.conduit.financial/customers/{id}/payment-methods \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-API-Secret: <api-key>' \
  --data '{
  "type": "bank",
  "rail": [
    "fedwire"
  ],
  "bankName": "Bank of America",
  "accountOwnerName": "John Doe",
  "accountNumber": "1234567890",
  "currency": "USD",
  "routingNumber": "1234567890",
  "address": {
    "streetLine1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "USA"
  }
}'
{
  "id": "bank_1234",
  "type": "bank",
  "rail": [
    "fedwire"
  ],
  "bankName": "Bank of America",
  "accountOwnerName": "John Doe",
  "accountNumber": "1234567890",
  "currency": "USD",
  "routingNumber": "1234567890",
  "status": "enabled",
  "address": {
    "streetLine1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "USA"
  },
  "entity": {
    "id": "cp_1234567890123456789012345",
    "name": "Mark Davis",
    "entityType": "individual",
    "complianceEntityType": "counterparty"
  }
}

Authorizations

X-API-Key
string
header
required

Includes an API key in the HTTP headers to authenticate the client.

X-API-Secret
string
header
required

Includes an API secret in the HTTP headers to authenticate the client.

Path Parameters

id
string
required

A valid Customer ID

Example:

"cus_2ofTA13AD0xBtbEvBl20aEb1hEu"

Body

application/json
  • Option 1
  • Option 2
type
enum<string>
required
Available options:
bank
rail
enum<string>[]
required
Maximum length: 1
bankName
string
required
accountOwnerName
string
required
currency
enum<string>
required

The asset identifier. A fiat currency code.

Available options:
USD,
MXN,
BRL,
COP,
EUR,
NGN,
ARS,
GBP
accountType
enum<string>
Available options:
savings,
checking,
electronic_deposit
accountNumber
string
iban
string
pixKey
string
routingNumber
string
swiftCode
string
branchCode
string
bankCode
string
sortCode
string
address
object

Response

Payment method created successfully

  • Bank Payment Method Response
  • Option 2
id
string
required

A valid Bank Account ID

Example:

"bank_2ofTA5mz0T91pBmD3tMTeLE7T4X"

type
enum<string>
required
Available options:
bank
bankName
string
required
currency
enum<string>
required

The asset identifier. A fiat currency code.

Available options:
USD,
MXN,
BRL,
COP,
EUR,
NGN,
ARS,
GBP
accountOwnerName
string
required
status
enum<string>
required
Available options:
enabled,
disabled
accountNumber
string
iban
string
pixKey
string
routingNumber
string
swiftCode
string
branchCode
string
bankCode
string
sortCode
string
accountType
enum<string>
Available options:
savings,
checking,
electronic_deposit
address
object
rail
enum<string>[]
entity
object
I