자금 지급

모든 페이아웃은 준비되고 충전된 발급 지갑에서 시작해요. 목적지 모델은 엔드포인트를 누가 소유하는지에 따라 달라져요.

시작 전에

출처 지갑을 다시 조회하세요. 현재 상태가 페이아웃을 허용하고 가용 잔액이 의도한 출처 금액을 감당하는지 확인하세요. 응답에서 파생된 ID를 SOURCE_WALLET_ID로 저장하세요. 또한 현재 고객과 선택한 목적지에 대해 준비된 페이아웃 케이퍼빌리티가 필요해요. 기존 Tron 지갑은 stablecoin_transfers 견적으로 다른 Tron 지갑에 USDT를 보낼 수 있어요. 입력과 출력은 동일한 네트워크와 스테이블코인을 사용해야 해요. Tron에서는 새 발급 지갑을 생성할 수 없어요.

1. 목적지 준비

자사
제3자

고객이 엔드포인트를 소유할 때 고객 소유 외부 은행 계좌를 사용하세요. POST /v3/customers/{customerId}/accounts와 다음 헤더로 생성하세요:

Request headers

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

Request body

{
  "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"
}

GET /v3/customers/{customerId}/accounts/{accountId}로 조회하세요. 현재 상태가 페이아웃을 허용할 때만 계속 진행하세요. acc_ ID를 PAYOUT_DESTINATION_ID로 저장하세요.

수취인과 목적지를 통해 개인 또는 기업과 그들의 은행 또는 지갑 엔드포인트를 생성하세요. 목적지가 준비되었을 때만 계속 진행하세요.반환된 dst_ ID를 PAYOUT_DESTINATION_ID로 저장하세요. 수취인의 rcp_ ID를 견적 목적지로 사용하지 마세요.

2. 페이아웃 견적 생성

다음 헤더로 POST /v3/quotes를 사용하세요:

Request headers

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

Request body

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "in": {
    "amount": "150.00",
    "currency": "USDC",
    "accountId": "${SOURCE_WALLET_ID}"
  },
  "destinationId": "${PAYOUT_DESTINATION_ID}",
  "out": {
    "currency": "USD"
  }
}

data.id를 QUOTE_ID로 저장하고 반환된 가격과 수수료를 표시하세요.

은행 경로 선택

암호화폐에서 법정화폐로의 페이아웃에서는 선택 사항인 institutionId를 설정해 고객에 대해 승인된 은행 경로를 요구할 수 있어요. 자동 라우팅을 사용하려면 생략하세요.

Request body with institutionId

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "institutionId": "${INSTITUTION_ID}",
  "in": {
    "amount": "150.00",
    "currency": "USDC",
    "accountId": "${SOURCE_WALLET_ID}"
  },
  "destinationId": "${PAYOUT_DESTINATION_ID}",
  "out": {
    "currency": "USD"
  }
}

명시적인 institutionId는 다른 은행으로 대체되지 않아요. 선택한 은행에 이 고객, 케이퍼빌리티, 목적지에 대해 준비된 경로가 없으면 POST /v3/quotes는 포인터 /institutionId와 함께 422 bank_not_supported_for_customer를 반환해요.
institutionId는 암호화폐에서 법정화폐로의 페이아웃 견적에서만 유효해요. 페이인, 카드 또는 스테이블코인 전송 견적에 보내면 400 validation_error가 반환돼요.
견적 및 전송 조회는 은행을 식별할 수 있는 경우 자동으로 선택된 경로를 포함해 선택된 경로의 institutionId를 그대로 반환해요.

SWIFT 페이아웃

프로덕션에서 USD SWIFT 페이아웃에는 페이아웃을 지원하는 준비된 SWIFT 케이퍼빌리티(swift_pooled 또는 swift_named)가 필요하며, Ethereum, Base, Polygon의 USDC 또는 Ethereum, Polygon의 USDT로 자금이 조달돼야 해요. 수수료 차감 후 수취 금액은 최소 100.00 USD여야 해요. SWIFT 목적지에는 bankAddress, bankCity, bankState, bankPostalCode에 은행의 도로명 주소가 필요해요. BIC 국가는 은행 국가와 일치해야 해요. Swipelux는 수혜자 주소를 고객 또는 수취인 프로필에서 가져와요.

Pix 페이아웃

Pix 및 Pix Safe 수취인 목적지는 BRL을 수취해요. 고객의 준비된 Pix 케이퍼빌리티(pix_pooled)로 페이아웃 견적을 생성하고, USDC로 자금을 조달하고, out.currency를 BRL로 설정하세요. USDT로는 BRL 페이아웃 자금을 조달할 수 없어요. Pix 페이아웃에는 개발자 수수료를 부과할 수 없어요. 출금 계정에 개발자 수수료가 설정되어 있다면 견적 요청에서 fees.breakdown.developer를 {"fixed": "0.00", "bips": 0}으로 설정하세요. 그렇지 않으면 POST /v3/quotes가 400 validation_error를 반환해요. Swipelux는 목적지의 은행 정보가 승인된 후에만 견적 가격을 산정해요. 확인이 진행되는 동안 POST /v3/quotes는 목적지가 아직 확인 중이라는 detail과 함께 400 validation_error를 반환하므로, 확인이 완료되면 새 견적을 요청하세요. 은행 정보가 거부되었거나 목적지 설정이 완료되지 않았다면 detail이 대신 지원팀에 문의하라고 안내하며, 지원팀이 설정을 완료할 때까지 새 견적은 계속 실패해요. 확인 상태를 확인할 수 없으면 503 quote_temporarily_unavailable을 반환하니 나중에 다시 시도하세요.

3. 페이아웃 실행

POST /v3/transfers로 전송을 생성하세요. 의도한 이 실행에 새 키 하나를 사용하세요:

Request headers

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

Request body

{
  "quoteId": "${QUOTE_ID}"
}

전송의 data.id를 TRANSFER_ID로 저장하세요. 성공적인 생성은 페이아웃을 시작해요. 전달을 증명하지는 않아요.

4. 전달 추적

생성 후 그리고 각 이벤트 이후에 GET /v3/transfers/{transferId}를 조회하세요. 최신 data.state, data.stateDetail, data.openTaskIds를 사용해 대기할지, 조치할지, 종료 결과를 표시할지 결정하세요. 다음으로 정확한 금액, 안전한 실행 복구, 전송 태스크에 대해 견적과 전송을 검토하세요.

시작하기

고객 온보딩

자금 흐름 구축

출시

시작 전에

1. 목적지 준비

2. 페이아웃 견적 생성

은행 경로 선택

SWIFT 페이아웃

Pix 페이아웃

3. 페이아웃 실행

4. 전달 추적

​시작 전에

​1. 목적지 준비

​2. 페이아웃 견적 생성

​은행 경로 선택

​SWIFT 페이아웃

​Pix 페이아웃

​3. 페이아웃 실행

​4. 전달 추적

시작 전에

1. 목적지 준비

2. 페이아웃 견적 생성

은행 경로 선택

SWIFT 페이아웃

Pix 페이아웃

3. 페이아웃 실행

4. 전달 추적