Skip to main content
이 페이지에는 Swipelux API에 대한 날짜별 변경 사항이 나열되어 있습니다. 각 항목에는 영향을 받는 버전, 변경 유형, 그리고 통합 담당자에게 요구되는 조치가 명시되어 있습니다. 기존 통합을 이전 버전에서 업그레이드하려면 v3로 마이그레이션을 참조하십시오.

미출시

출시 예정인 변경 사항은 배포 전에 여기에 나열됩니다.

2026-09-08

버전: v3

변경

  • POST /v3/transfers와 전송 조회가 카드 체크아웃 미리 선택에 paymentMethod 대신 checkoutMethod를 사용하고 card, apple_pay, google_pay, cash_app, sepa, blik을 받아요. 이 목록은 열려 있고 늘어날 수 있어요. paymentMethod는 더 이상 인식되지 않아요. 여전히 보내는 요청은 생략한 것처럼 처리돼요. sepa와 blik은 카드 체크아웃 내부의 결제 옵션이지 Swipelux의 기능이 아니에요. 자금 수취를 참조하세요.

2026-09-07

버전: v3

추가

  • POST /v3/transfers가 카드 견적에 대해 선택 사항인 paymentMethod(card, apple_pay 또는 google_pay)를 받아요. 요청한 방식이 고객과 고객의 기기에서 사용 가능하면 호스팅된 체크아웃이 그 방식으로 열리고, 전송 조회는 요청을 그대로 돌려주며, 견적의 금액과 수수료는 변하지 않아요. 자금 수취를 참조하세요.

2026-08-31

버전: v3

추가

  • 실소유자가 없는 비즈니스에 대해 기능을 요청하면 이제 503으로 실패하는 대신 실소유자를 추가하기 위한 접수 작업이 생성됩니다. 진행할 수 없는 요청은 신고된 소유권 또는 25% 이상의 소유권을 가진 개인 관계자를 추가하라는 안내와 함께 422 beneficial_owner_required를 반환합니다. 주주, UBO, 통제 담당자를 참조하세요.
  • 판매자 패널의 작업 테이블에 이제 각 요청의 대상과 기능 범위가 표시되어, 규정 준수 요청이 누구와 무엇을 대상으로 하는지 확인할 수 있습니다. 기능 및 요구 사항을 참조하세요.
  • 판매자 패널의 업종 분류 필드는 이제 고객 프로필과 요구 사항 작업에서 검색 가능한 NAICS 코드를 제공합니다. KYB 워크플로를 참조하세요.

변경

  • 진행 중인 은행 설정과 충돌하는 은행 상세 정보 제출은 이제 409 ops_rail_handoff_conflict를 반환합니다. 문서를 다시 업로드하지 말고, 업로드한 문서 ID를 보관했다가 충돌이 해결된 후 동일한 제출을 재시도하세요. 오류 및 재시도를 참조하세요.
  • 고객 지갑으로의 사전 통지 없는 스테이블코인 입금의 최소 금액이 이제 10단위에서 1단위로 변경되었습니다. 그보다 작은 입금은 계속 더스트로 처리됩니다. 자금 수취를 참조하세요.
  • 웹훅 구성이 이제 환경별로 분리됩니다. 웹훅 포털은 요청한 환경으로 범위가 지정되어 열리므로, 샌드박스와 프로덕션 엔드포인트가 더 이상 설정을 공유하지 않습니다. 웹훅을 참조하세요.
  • 판매자 패널은 이제 고객의 v3 기능에서 사용 가능한 pay-in 방법을 도출하므로, 계좌 설정에서는 고객에게 권한이 있는 방법만 제공됩니다. 계좌를 참조하세요.
  • RFI 양식은 이제 더 짧고 명확한 안내 문구로 해당 실소유자를 수집하며, RFI 기록은 수명 주기 마일스톤으로 표시됩니다. 문서 요구 사항을 참조하세요.

제거

  • 판매자 패널은 새 pay-in 방법을 추가할 때 더 이상 Fedwire를 제공하지 않습니다. 기존 Fedwire 계좌는 계속 조회할 수 있습니다. 계좌를 참조하세요.

수정

  • 고객 지갑으로의 사전 통지 없는 USDT 입금이 이제 무시되지 않고 인식되어 정산됩니다.
  • 이미 제출한 증빙이 동일한 항목을 요구하는 다른 작업으로 이월되어, 고객이 같은 문서를 두 번 요청받지 않습니다.
  • 기능을 다시 요청해도 이미 준비된 은행 경로가 폐기되지 않으므로, 발급된 계좌 상세 정보가 안정적으로 유지됩니다.
  • 판매자 패널의 은행 지침 화면에 이제 SWIFT 주소와 대상 지갑 주소를 포함한 완전한 상세 정보가 표시됩니다.
  • RFI 양식은 이제 제출 검증 오류를 표시하고, 제출 전에 법적 형태 설명을 검증하며, 여러 비즈니스 웹사이트를 허용합니다.
  • 이제 RFI 양식에서 제출하기 전에 관계자 초안을 편집할 수 있습니다.
  • 취소된 규정 준수 요청이 더 이상 판매자 패널 작업 목록에 표시되지 않습니다.
  • 판매자 패널에서 문서 검토 상태가 다시 올바르게 표시됩니다.

2026-08-24

버전: v3

추가

  • 고객 범위의 호스팅된 인증 및 서비스 약관 세션에 이제 신뢰 기준이 되는 action 객체가 포함됩니다. available 또는 unavailable 종류를 따르세요. 사용 가능한 작업의 경우 최상위 url 및 expiresAt 필드는 호환성 미러로 유지됩니다. 기능 및 요구 사항을 참조하세요.
  • 샌드박스 지갑 충전은 이제 GET /v3/transfers/{transferId}로 조회하거나 GET /v3/transfers로 나열할 수 있는 송금 ID를 반환합니다. 완료된 인바운드 스테이블코인 입금으로 표시됩니다. 샌드박스에서 테스트를 참조하세요.

변경

  • 카드 및 Apple Pay용 판매자 패널의 First pay-in 안내는 이제 고객에게 Polygon 지갑이 있어야 진행할 수 있습니다. 안내를 시작하기 전에 해당 지갑을 생성하세요. 계좌를 참조하세요.
  • 새 요청과 공개 응답은 메서드 및 기능의 표준 이름으로 sepa를 사용합니다. sepa_instant 입력 별칭과 이전에 저장된 리소스는 계속 호환되지만 공개 응답은 sepa를 사용합니다. 계좌를 참조하세요.
  • 새로운 Faster Payments 기능, 발급 계좌 및 견적 요청은 사용할 수 없습니다. 기존 계좌, 견적 및 송금은 계속 조회할 수 있습니다. 계좌를 참조하세요.
  • KYB 첫 페이지에서 더 이상 대표자의 생년월일을 수집하지 않습니다. 주주의 생년월일은 별도의 요구 사항으로 유지됩니다. KYB 워크플로를 참조하세요.
  • RFI 문서 참조는 이제 image/jpeg 외에 MIME 별칭 image/jpg도 허용합니다. 문서 요구 사항을 참조하세요.
  • 판매자 패널의 작업 기록은 이제 리비전 카운터 없이 읽기 쉬운 감사 추적을 표시합니다. 기능 및 요구 사항을 참조하세요.

제거

  • 판매자 패널은 더 이상 새로운 UAEFTS 계좌 설정을 제공하지 않습니다. 기존 UAEFTS 계좌는 계속 조회할 수 있습니다. 계좌를 참조하세요.

수정

  • 검토자가 새 문서 제출 항목을 추가해도 RFI 양식의 기존 입력이 유지되어 다시 제출할 때 이전 답변이 손실되지 않습니다.
  • 판매자 패널은 유효한 링크를 버리지 않고 사용 가능한 작업에서 호스팅된 규정 준수 세션을 재개합니다.
  • 호스팅된 서비스 약관 링크가 이제 API가 반환하는 모든 작업 범위에서 작동합니다.
  • 판매자 패널에서 Payment Access를 요청하면 이전 요청의 작업 대신 해당 요청이 반환한 접수 작업을 엽니다.
  • 판매자 패널의 KYB 데모는 이제 현재 필수 필드를 요청합니다.
  • 소스 지갑을 destinationId로 다시 사용하는 견적은 이제 공급자 작업을 시작하기 전에 조치 가능한 422 quote_direction_invalid 세부 정보를 반환합니다. 견적 및 송금을 참조하세요.
  • API는 잘못된 쿼리 문자열 인코딩을 자동으로 정규화하지 않고 400 오류로 거부합니다. 오류 및 재시도를 참조하세요.
  • POST /v3/customers/{customerId}/documents는 이제 비어 있거나 multipart가 아니거나 형식이 잘못된 요청 본문을 400 오류로 거부합니다.

2026-08-17

버전: v3

추가됨

  • OpenAPI 스펙에 v3 Problem Details 카탈로그를 게시하여, 통합 담당자가 스키마에서 직접 오류 응답을 매핑할 수 있도록 했습니다. Errors.
  • v3 계좌 웹훅 이벤트에 customerId를 추가하여, 후속 읽기 없이 계좌 활동을 소유 고객과 연관시킬 수 있습니다. 웹훅을 참조하십시오.
  • 머천트 패널에서 V3 개인 프로필 필드를 완전히 지원하여, 온보딩 담당자가 v3 API를 통해 수집된 모든 KYC 필드를 검토하고 편집할 수 있습니다. 고객 온보딩을 참조하십시오.
  • v3 개발자 마이그레이션 가이드를 게시했습니다. v3로 마이그레이션을 참조하십시오.

변경됨

  • 고객 및 계좌의 국가 코드는 쓰기 시점에 할당된 ISO 3166-1 alpha-2 값으로 검증됩니다. 읽기는 레거시 저장 값을 허용하므로, 기존 레코드는 계속 해석됩니다. 계좌와 지갑을 참조하십시오.
  • USDC 가용성은 이제 목적지 네트워크에 따라 범위가 지정되므로, 견적과 전송은 목적지가 실제로 지원하는 네트워크에서만 USDC를 제공합니다.
  • Capability.ready는 권한 승인을 나타내며 계좌 발급을 의미하지 않습니다. 계좌 발급 상태는 accountProvisioning에서 확인하세요: not_applicable, not_started, in_progress, issued, failed.
  • iPhone에서 업로드된 HEIC 파일이 신원 및 주소 증명 서류로 이제 허용됩니다.

수정됨

  • 이미 소비된 견적을 재실행하면 일반 오류가 아닌 409 quote_execution_consumed을 반환합니다. 견적과 전송을 참조하십시오.
  • 전송 목록 읽기와 견적 금액 읽기가 대규모 과거 결과에서 더 이상 500 오류를 발생시키지 않습니다.
  • 개인 고객에 대한 관계자 읽기가 더 이상 404를 반환하지 않습니다.
  • 머천트 패널의 검증 링크 행에서 모든 행에 Open 액션이 표시되고, 모든 지갑 인프라 태스크 링크가 요구 사항 뷰에 렌더링됩니다.