계좌와 지갑

모든 계좌는 하나의 고객에게 속해요. 두 가지 차원을 사용해 선택하세요: 누가 관리하는지, 그리고 지갑인지 은행 계좌인지.

계좌 선택

계좌	용도
발급 지갑	커스터디 스테이블코인 잔액 보유, 페이아웃 자금 조달, 페이인 수취, 발급 은행 계좌 정산
발급 은행 계좌	발급 지갑으로 정산되는 재사용 가능한 은행 정보를 고객에게 제공
외부 지갑	고객이 소유한 블록체인 주소 기록
외부 은행 계좌	자사 페이아웃을 위해 고객이 소유한 은행 계좌 기록

issued는 Swipelux가 리소스를 생성하고 관리한다는 뜻이에요. external은 고객이 소유한 엔드포인트를 기록해요. 제3자 엔드포인트는 고객 계좌 목록이 아니라 수취인과 목적지 아래에 속해요.

계좌 생성

POST /v3/customers/{customerId}/accounts를 사용하세요. 아래 요청 본문 중 하나와 함께 이 헤더를 보내세요:

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: account-create-001
Content-Type: application/json

발급 지갑
발급 은행 계좌
외부 지갑
외부 은행 계좌

{
  "origin": "issued",
  "type": "wallet",
  "currency": "USDC",
  "network": "base",
  "label": "Settlement wallet"
}

{
  "origin": "issued",
  "type": "bank",
  "method": "ach",
  "country": "US",
  "currency": "USD",
  "settlement": {
    "accountId": "${SETTLEMENT_WALLET_ID}"
  },
  "label": "USD account"
}

{
  "origin": "external",
  "type": "wallet",
  "currency": "USDC",
  "network": "polygon",
  "details": {
    "address": "0x4997b0a68bebc1b0d80a93567ba7002be92b8b11"
  },
  "label": "Customer Polygon wallet"
}

{
  "origin": "external",
  "type": "bank",
  "methods": ["ach", "wire"],
  "country": "US",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Acme Payments SAS"
  },
  "label": "Customer operating account"
}

현재 고객과 케이퍼빌리티에 대해 반환된 통화, 네트워크, 방법, 계좌 유형만 사용하세요. 다른 고객이나 환경에서 가용성을 복사하지 마세요.

계좌가 사용 가능해질 때까지 대기

생성 응답에서 data.id, data.status, data.openTaskIds를 저장하세요. 전송을 견적하거나 은행 정보를 표시하기 전에 GET /v3/customers/{customerId}/accounts/{accountId}로 최신 계좌를 조회하세요. 현재 상태가 다음 동작을 허용할 때만 계좌를 사용하세요. 태스크 ID가 열려 있으면 케이퍼빌리티와 태스크를 통해 완료하세요. 발급 은행 계좌는 프로비저닝 중에 details: null을 반환할 수 있어요. 현재 조회가 전체 세트를 반환한 이후에만 은행 정보를 표시하세요. details.referenceRequired가 true이면 은행 좌표와 함께 정확한 details.reference를 표시하세요.

계좌 역할을 명확하게 유지

페이아웃에서 발급 지갑은 in.accountId의 출처예요. 고객 소유 은행 계좌는 destinationId예요. 발급 은행 계좌에서 settlement.accountId는 매칭된 입금을 수취하는 발급 지갑이에요. 다음으로 자금 수취, 자금 지급, 은행 계좌 발급에서 준비된 계좌를 사용하세요.

시작하기

고객 온보딩

자금 흐름 구축

출시

계좌 선택

계좌 생성

계좌가 사용 가능해질 때까지 대기

계좌 역할을 명확하게 유지

​계좌 선택

​계좌 생성

​계좌가 사용 가능해질 때까지 대기

​계좌 역할을 명확하게 유지

계좌 선택

계좌 생성

계좌가 사용 가능해질 때까지 대기

계좌 역할을 명확하게 유지