Skip to main content

​
Pre-requisites

  • You have an active Conduit account with API access
  • You have API credentials (API Key and Secret)
  • You have a customer onboarded as instructed in Create Your First Customer guide.
  • You have read our Payment Methods Core Concepts
1

Choose Payment Method Type

​
Step 1: Choose Payment Method Type

Decide which type you need:
  • Bank Account: For fiat currency transactions (onramp/offramp, traditional payments)
  • Crypto Wallet: For cryptocurrency transactions (onramp/offramp, crypto transfers)
Endpoint: POST /customers/id/payment-methods
2

Create a Bank Account Payment Method

Let’s add a bank account that can receive fiat currency withdrawals.

​
Request Example

curl --request POST \
  --url https://api.conduit.financial/customers/id/payment-methods \
  --header "X-API-Key: your_api_key" \
  --header "X-API-Secret: your_api_secret" \
  --header "Content-Type: application/json" \
  --header "Api-Version: 2024-12-01" \
  --data '{
  "type": "bank",
  "currency": "USD",
  "address": {
    "streetLine1": "656"
  },
  "rail": [
    "fedwire"
  ],
  "bankName": "Bank of America",
  "accountOwnerName": "John Doe",
  "accountType": "savings",
  "accountNumber": "1234567890",
  "iban": "435677889867876",
  "pixKey": "7568769879",
  "routingNumber": "1234567890",
  "swiftCode": "153657",
  "branchCode": "46576",
  "bankCode": "577",
  "sortCode": "65676"
}'

​
Response Example

{
  "id": "bank_1234",
  "type": "bank",
  "rail": [
    "fedwire"
  ],
  "bankName": "Bank of America",
  "accountOwnerName": "John Doe",
  "accountNumber": "1234567890",
  "currency": "USD",
  "routingNumber": "1234567890",
  "swiftCode": "153657",
  "branchCode": "46576",
  "bankCode": "577",
  "sortCode": "65676",
  "iban": "435677889867876",
  "status": "enabled",
  "address": {
    "streetLine1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "USA"
  },
  "entity": {
    "id": "cus_1234567890123456789012345",
    "name": "Mark Davis",
    "entityType": "business",
    "complianceEntityType": "customer"
  }
}
Success! Save this bank_1234 - you’ll need it for transactions involving your customer.
3

Create a crypto wallet payment method

Let’s add a crypto wallet that can receive cryptocurrency.

​
Request Example

curl --request POST \
  --url https://api.conduit.financial/customers/id/payment-methods \
  --header "X-API-Key: your_api_key" \
  --header "X-API-Secret: your_api_secret" \
  --header "Content-Type: application/json" \
  --header "Api-Version: 2024-12-01" \
  --data '{
    "type": "wallet",
    "rail": "tron",
    "walletAddress": "TXYZa1b2c3d4e5f6g7h8i9j0k1l2m3n4o5",
    "walletLabel": "My TRON Wallet"
  }'

​
Response Example

{
  "id": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
  "type": "wallet",
  "rail": "tron",
  "walletAddress": "TXYZa1b2c3d4e5f6g7h8i9j0k1l2m3n4o5",
  "walletLabel": "My TRON Wallet",
  "status": "enabled",
  "entity": {
    "id": "cus_1234567890123456789012345",
    "name": "Mark Davis",
    "entityType": "business",
    "complianceEntityType": "customer"
  }
}
Success! Save this wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO - you’ll need it for transactions involving your customer.

​
🎉 You’re Done!

Once your payment methods are added, they’re ready for transactions. What you can do now:
  • Ready to use in onramp transactions (fiat to crypto)
  • Ready to use in offramp transactions (crypto to fiat)
  • Can be referenced in any payment flow
What’s next
In the next guide, learn how to create your customer’s first counterparty: Create Your Customer’s First Counterparty.
⌘I