Swipelux API 변경 이력 및 릴리스 노트

​

추가

• 수취인 목적지는 브라질의 BRL 지급을 위해 pix 및 pix_safe 유형을 허용합니다. Pix 목적지는 Pix 키로 지급합니다. Pix Safe 목적지는 예금주의 CPF 또는 CNPJ, 은행의 ISPB 코드, 지점, 계좌 번호로 식별되는 은행 계좌로 지급합니다. 두 유형 모두 고객의 준비된 Pix 기능(pix_pooled)이 필요하며, 해당 지급은 USDC로 자금이 조달되고 개발자 수수료가 부과되지 않습니다. 수취인 및 자금 지급을 참조하세요.
• GET /v3/customers/{customerId}/tasks/{taskId}는 문서 요구 사항 ID를 지정하는 documentCandidatesFor와 대안이 있는 요구 사항을 위한 documentAlternativeKey를 허용합니다. 이 경우 응답의 data.documentCandidates에 고객이 이미 업로드한 파일 중 해당 요구 사항에 응답할 수 있는 파일이 missingMetadata 또는 conflictingMetadata와 함께 나열됩니다. 파일을 다시 업로드하는 대신 후보의 documentId를 누락된 documentMetadata와 함께 제출하세요. 이 쿼리에는 accounts:read와 customers:read가 필요하며, 잘못된 선택은 400 validation_error를 반환합니다.

​

변경

• GET /v3/webhooks/portal은 1시간 후 만료되는 포털 URL을 Cache-Control: no-store와 함께 반환합니다. webhooks:write 권한이 있는 API 키를 사용하면 포털에 엔드포인트 서명 시크릿이 표시되며 엔드포인트 관리, 전달 재시도, 재생이 가능합니다. webhooks:read만 있으면 포털에는 전달 내역만 표시됩니다. 웹훅을 참조하세요.
• Citi(citibank)는 법인 고객에게만 제공됩니다. 모든 법인은 풀링 Citi를 계속 사용할 수 있으며, 명의 Citi는 미국 외 지역에 등록된 법인에게만 제공됩니다. 고객에게 Citi가 제공되지 않으면 지원 목록에서 Citi가 제외되고, Citi를 지정하면 422 capability_institutions_unsupported를 반환하며, Citi만 제공하는 방법은 disabled로 표시됩니다. institutions가 없는 요청은 나머지 은행 중에서 선택합니다. 기존 신청과 계좌는 변경되지 않습니다.
• 명의 CFSB(cfsb) 기능은 미국 고객, 즉 미국에 등록된 법인과 미국에 거주하는 개인에게만 제공됩니다. 그 외 고객의 경우 지원 목록에서 명의 CFSB가 제외되고, 이를 지정하면 422 capability_institutions_unsupported를 반환합니다. institutions가 없는 요청은 나머지 은행 중에서 선택합니다. 풀링 CFSB, 국가를 알 수 없는 고객, 기존 신청은 변경되지 않습니다.
• Lead Bank(lead_bank) 명의 ACH, Wire, SWIFT 기능은 법적 형태와 국가를 기준으로 Lead Bank가 온보딩할 수 있는 고객에게만 제공됩니다. 그 외 고객의 경우 지원 목록에서 lead_bank가 제외되고, 이를 지정하면 422 capability_institutions_unsupported를 반환합니다. Lead Bank가 이미 온보딩한 고객과 진행 중인 요청에서 이미 lead_bank를 지정한 기능은 이를 유지합니다. 기존 신청과 계좌는 변경되지 않습니다.
• RTP는 풀링 방식만 제공됩니다. 새 요청에 rtp_named를 제공하는 은행이 없으므로 지원 목록에서 disabled로 표시됩니다. rtp_named를 보유하지 않은 고객의 경우, 은행을 지정한 기능 요청 또는 작업 미리보기는 422 capability_institutions_unsupported를 반환하고, institutions가 없는 요청은 422 capability_variant_unavailable을 반환합니다. 풀링 RTP(rtp_pooled)는 Citi에서 제공되므로 법인 고객만 요청할 수 있습니다.
• 개인 및 실소유자에 대한 새 신분증 문서 요청은 constraints.identityMetadataRequired: true를 설정할 수 있으며, 이 경우 각 파일의 documentMetadata에 ID 번호와 발급 국가가 필요합니다. 법인 주소 증명 및 소유자 거주 증명에 대한 새 요청은 constraints.maxIssueAgeDays: 90을 설정할 수 있으며, 이 경우 각 파일에 발급일이 필요합니다. 기존 작업은 요구 사항을 유지하므로 각 작업 요청의 제약 조건을 확인하세요.
• profilePointer가 /business/registration인 법인 등록 요청에 대한 작업 답변에는 관할 국가, 등록 번호, 제출일 이전의 설립일이 모두 함께 필요합니다. 요청의 valueSchema가 이 규칙을 게시하며, 일부만 포함된 답변은 400 validation_error를 반환합니다.
• 호스팅된 인증 후, 주소나 세금 식별자와 같은 구조화된 값에 대한 프로필 요구 사항의 호스팅된 답변은 직접 답변과 동일한 스키마 및 제약 조건 검사를 통과하는 경우에만 Swipelux가 수락합니다. 그렇지 않으면 요구 사항은 열린 상태로 유지되며, 해당 값을 POST /v3/customers/{customerId}/tasks/{taskId}/submissions로 제출해야 합니다. 이 이유로 Swipelux가 action_required로 되돌린 요구 사항에는 reviewFeedback.code: hosted_profile_direct_submission_required가 포함됩니다. 이미 satisfied인 작업은 상태를 유지합니다. 기능 및 요구 사항을 참조하세요.
• 호스팅된 인증으로 거부된 작업은 해당 인증 결정이 나중에 번복되면 rejected 상태에서 벗어날 수 있습니다. 이 경우 작업은 satisfied가 되거나, 새 revision에서 action_required가 되며 새 결정이 답하지 않는 요구 사항이 다시 열립니다. 해당 요구 사항에 대한 이전 제출은 rejected로 유지되므로 해당 답변을 다시 제출하세요. v3로 마이그레이션을 참조하세요.
• 수취인 목적지 type은 이제 개방형 열거형입니다. 이 레퍼런스의 이전 버전에서는 폐쇄형으로 설명되었으므로, 알 수 없는 유형을 거부하거나 버리는 클라이언트를 업데이트하세요. 목적지 응답과 destination.status_changed 이벤트에 이제 pix 및 pix_safe가 포함될 수 있으며, 앞으로 더 많은 유형이 추가될 수 있습니다.
• 수취인 생성 및 업데이트 요청은 중첩된 address를 포함하여 정의되지 않은 필드를 400 validation_error를 반환하는 대신 무시합니다. 생성 요청에서 다른 수취인 유형의 이름 또는 업종 필드는 여전히 400을 반환하며, PATCH /v3/customers/{customerId}/recipients/{recipientId}의 type 및 externalId도 마찬가지입니다. 인식하는 필드가 하나도 없는 PATCH는 200 대신 400 validation_error를 반환합니다.
• 문서만 요청하는 대상 세션의 인증 링크는 이제 Swipelux가 호스팅하는 문서 업로드 페이지를 엽니다. 링크 자체는 변경되지 않으며, 다른 세션은 계속 호스팅된 인증 플로를 엽니다.
• 개인 고객과 관계자 개인의 employment.occupation은 최대 255자까지 허용합니다.
• 프로필 값이나 작업 답변에 RFI, 고객 요청, 송금 추적 링크와 같은 Swipelux 양식 링크가 포함되어 있으면 POST /v3/customers, PATCH /v3/customers/{customerId}, POST /v3/customers/{customerId}/related-parties, PATCH /v3/customers/{customerId}/related-parties/{relatedPartyId} 및 POST /v3/customers/{customerId}/tasks/{taskId}/submissions은 400 validation_error를 반환합니다. 이는 externalId 또는 metadata에는 적용되지 않습니다. 거부된 각 값은 code: public_form_link 및 해당 JSON Pointer와 함께 errors[]에 표시되며, 응답은 링크를 절대 반복하지 않습니다. 대신 정보 자체를 보내세요. 오류 및 재시도를 참조하세요.

​

수정

• 지급 견적 및 전송 응답은 USDC 또는 USDT 출금 금액을 소수점 이하 6자리로 유지합니다(예: 4009.71 대신 4009.711365). 법정화폐 금액은 소수점 이하 2자리를 유지합니다. 스테이블코인 출금 금액이 소수점 이하 2자리를 넘는 지급을 생성하거나 조회해도 더 이상 500을 반환하지 않습니다.
• POST /v3/customers/{customerId}/capabilities/{capabilityId}/cancel 레퍼런스가 이제 실제 동작대로 취소를 설명합니다. ready 상태의 기능은 취소할 수 있고, stablecoin_transfers 기능은 취소할 수 없으며, 취소는 해당 기능만 종료하고 그 신청의 상태, 작업, 승인은 유지됩니다.
• institutions에 공개 기관 ID 대신 은행 코드(예: citibank 대신 citi)를 나열한 기능 요청 또는 작업 미리보기는 503 kyc_configuration_unavailable 대신 사용 가능한 ID를 알려주는 422 capability_institutions_unsupported를 반환합니다.
• 고객에게 제공하는 은행이 없는 방법(지원 목록에서 disabled로 표시됨)에 대한 기능 요청 또는 작업 미리보기는 고객이 이미 해당 기능을 보유한 경우를 제외하고 503 kyc_configuration_unavailable 대신 retryable: false와 함께 422 capability_variant_unavailable을 반환합니다.
• documentCandidates에 더 이상 완료된 호스팅 인증에서 Swipelux가 보관하는 파일(읽거나 다운로드할 수 없음)이 나열되지 않습니다. 이러한 파일을 인용한 작업 답변은 알 수 없는 문서와 마찬가지로 400 invalid_document_reference를 반환합니다.

​

추가

• GET /v3/customers는 include=documentRequirements를 허용합니다. 이 경우 각 고객 요약에 기능 준비 상태와 관계없이 아직 제출되지 않은 필수 문서 수가 표시됩니다. include=capabilities,documentRequirements처럼 함께 사용할 수 있습니다. 고객을 참조하세요.
• 판매자 패널의 Webhooks 페이지에서 엔드포인트 메뉴에 Replay missed events가 추가되었습니다. 엔드포인트가 받지 못한 최근 13일간의 이벤트를 다시 보내며, 같은 이벤트를 두 번 보내지 않습니다. 웹훅을 참조하세요.
• 판매자 패널의 Settings 페이지에 Compliance 섹션이 추가되었습니다. 소유자와 관리자는 컴플라이언스 이메일을 설정하고, Swipelux가 고객에 대한 추가 정보를 요청할 때 이메일을 받을지 선택할 수 있습니다.
• 판매자는 판매자 패널의 KYB 페이지에서 자신의 KYB 컴플라이언스 요청에 바로 답변할 수 있습니다.

​

변경

• 은행 접수가 완료된 후에도 고객 및 관계자 업데이트는 더 이상 409 field_conflicts_with_completed_intake를 반환하지 않습니다. 업데이트는 저장되며, 새 은행 신청마다 자체 요구 사항에 따라 최신 프로필을 확인합니다.
• 기능의 기존 은행 라우팅을 안전하게 업데이트할 수 없으면 기능 요청이 409 capability_route_header_conflict를 반환합니다. 다시 시도하기 전에 Swipelux 지원팀에 문의하세요.
• institutions에 기능이 제공하지 않는 은행이 지정되면 GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-preview는 기능 요청과 마찬가지로 422 capability_institutions_unsupported를 반환합니다.
• 샌드박스에서 ACH, Wire, SWIFT 기능은 JPMorgan Chase에서만 제공됩니다. institutions를 생략한 요청은 jpmorgan을 선택하며, 다른 은행을 지정하면 422 capability_institutions_unsupported를 반환합니다. 라이브 라우팅은 변경되지 않습니다. 샌드박스에서 테스트를 참조하세요.
• 시뮬레이션된 케이스가 요청한 상태에 도달할 수 없으면 샌드박스 기능 상태 강제 변경은 statusReason과 함께 409 capability_status_blocked를 반환합니다. 이미 적용된 강제 변경을 반복하면 변경 없이 200을 반환합니다. 샌드박스에서 테스트를 참조하세요.
• POST /v3/sandbox/tasks/{taskId}/review는 Operations 또는 다른 워크플로가 소유한 태스크에 대해 409 task_not_sandbox_reviewable을 반환해요. POST /v3/sandbox/tasks의 태스크와 Swipelux가 수집하는 케이퍼빌리티 접수 태스크는 계속 검토할 수 있어요. 샌드박스에서 테스트를 참고하세요.
• 은행에서 계좌 프로비저닝이 아직 진행 중일 때 정산을 변경하면 PATCH /v3/customers/{customerId}/accounts/{accountId}가 409 account_provisioning_unresolved를 반환합니다. 프로비저닝이 확정된 후 다시 시도하세요. 오류 및 재시도를 참조하세요.
• POST /v3/transfers는 409 quote_execution_evidence_conflict를 반환할 수 있습니다. 새 견적을 생성하여 실행하세요. 오류 및 재시도를 참조하세요.
• 판매자 패널의 Pay out 드로어는 전체 목적지 정보를 표시하고, 계좌 번호와 지갑 주소를 토글 뒤에 마스킹하며, 결제 수단별 예상 도착 시간을 표시합니다.
• 판매자 패널은 은행 계좌를 고객의 Payment access 탭으로 통합하고, 각 은행 이름을 표시하는 작업 카드를 제공합니다. Documents 탭은 Profile로 이동했습니다.
• 판매자 패널에서 이름이 지정된 은행 계좌 개설은 이제 단일 단계로 진행되며, 각 은행의 통화, 방식, 온보딩 소요 시간이 나열됩니다. 계좌를 참조하세요.
• 검토를 위해 보류된 은행 계좌는 판매자 패널에 On hold로 표시되며, 계좌 ID와 Contact support 작업이 함께 표시됩니다.
• Swipelux가 제출할 신청서를 준비 중이고 진행 중인 검토가 없는 동안, pending 케이퍼빌리티는 이제 review_in_progress 대신 statusReason.code: preparing_submission을 보고합니다. 두 코드 모두 resolution: wait를 사용합니다. 둘 사이에서 변경되어도 상태는 pending으로 유지되므로 capability.status_changed 이벤트는 전송되지 않습니다. 기존 케이퍼빌리티는 다음 재평가 시 새 코드를 적용받습니다. 기능 및 요구 사항을 참고하세요.
• 판매자 패널의 고객 Payment access 탭에 있는 Shared methods 표는 케이퍼빌리티가 preparing_submission을 보고하는 공유 수단에 대해 In review 대신 In preparation을 표시합니다.
• 케이퍼빌리티의 applications 목록은 이제 케이퍼빌리티 조회(GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications 포함), 케이퍼빌리티 요청 응답, capability.status_changed 이벤트에서 현재 신청만 표시합니다. 더 새로운 신청으로 대체된 신청은 여전히 GET /v3/customers/{customerId}/applications에 표시되며, supersededByApplicationId가 후속 신청을 나타냅니다. 대체된 신청의 열린 태스크는 여전히 케이퍼빌리티의 openTaskIds에 포함됩니다. 케이퍼빌리티의 상태와 openTaskIds는 변경되지 않으므로 이 변경 자체로는 webhook 이벤트가 전송되지 않습니다. 기능 및 요구 사항을 참고하세요.

​

수정

• 은행 승인 전에 같은 발급 계좌에 대해 보낸 두 번째 allowPending 요청은 500 대신 holder.accountId에 대기 중인 계좌를 명시한 409를 반환합니다. 은행 계좌 발급을 참조하세요.
• 기능을 취소하면 아직 은행 승인을 기다리던 발급 계좌 요청이 종료되므로, 이후 같은 은행에 대한 요청은 새로 시작됩니다.
• 은행 건이 모두 거절된 취소된 기능을 재요청하면 canceled에서 시작하는 capability.status_changed 이벤트가 하나만 발행됩니다.
• 이전 신청이 아카이브된 후 은행을 재요청하면 이제 새 신청이 제출됩니다.
• 수취인 목적지는 해당 기능이 ready 상태가 되는 즉시 추가할 수 있으며, 더 이상 409 rail_not_ready를 반환하지 않습니다. 수취인을 참조하세요.
• 판매자 패널의 Webhooks 페이지를 처음 열기 전에 전송된 웹훅 이벤트가 이제 보존되므로, 새 엔드포인트로 재전송할 수 있습니다.
• 판매자 패널의 작업 마감일이 사용자의 시간대로 표시되며, 은행 검토 드로어에는 남은 항목이 없으면 All requirements submitted가 표시됩니다.

​

추가

• POST /v3/quotes는 이제 암호화폐-법정화폐 지급 견적에 대해 승인된 은행 경로를 선택할 수 있는 선택적 institutionId를 허용합니다. 자동 라우팅을 유지하려면 생략하세요. 해당 지급에 사용할 수 없는 은행을 지정하면 422 bank_not_supported_for_customer를 반환하고, 다른 유형의 견적에 institutionId를 보내면 400 validation_error를 반환합니다. 자금 지급을 참조하세요.
• POST /v3/customers/{customerId}/accounts의 발급된 은행 계좌 요청은 대체 은행 없이 계좌를 하나의 은행에 고정하는 institution과, 해당 은행의 신청이 아직 승인 대기 중인 동안에도 요청을 저장하는 allowPending: true를 허용합니다. allowPending에는 institution이 필요합니다. 저장된 요청은 해당하는 applicationId를 보고합니다. 은행 계좌 발급을 참조하세요.
• 판매자 패널에 엔드포인트를 관리할 수 있는 기본 Webhooks 페이지가 추가되었습니다. 웹훅을 참조하세요.
• 판매자 패널에 이름이 지정된 은행 계좌, 암호화폐 입금, 검토 단계를 갖춘 Pay in 드로어가 추가되었습니다.
• 판매자 패널의 Pay out 플로는 소스 선택기에 지갑 잔액을 표시하고, Max 금액 옵션을 추가하며, 검토 단계를 포함합니다.
• 판매자 패널의 고객 프로필에 Recipients & destinations 탭이 추가되었습니다.
• 작업 요구 사항에 짧은 title 제목을 포함할 수 있습니다. 안내 내용은 계속 요청의 prompt에 담깁니다. 기능 및 요구 사항을 참조하세요.

​

변경

• 공유(pooled) Wire 경로의 Wire pay-in 견적은 이제 최소 $20이 필요합니다. 경로의 최소 금액 미만이거나 이체 수수료를 충당하기에 너무 적은 견적은 일반적인 견적 실패 대신 422 amount_not_deliverable을 반환합니다. 자금 수취를 참조하세요.
• 웹훅 포털은 이제 v3 이벤트 유형을 리소스별로 그룹화하고 각 이벤트의 페이로드 스키마와 예시를 표시합니다. 레거시 이벤트 유형은 별도의 Legacy 그룹에 나타나며 지원 중단으로 표시됩니다. 이미 이를 구독 중인 엔드포인트는 계속 수신합니다. 새 구독에는 v3 이벤트 유형을 사용하세요. 웹훅을 참조하세요.
• 샌드박스 충전은 이제 transfer.created 및 transfer.state_changed 웹훅 이벤트를 발생시킵니다. 샌드박스에서 테스트를 참조하세요.
• 고객에게 이미 활성 상태의 발급 계좌가 있는 경우 accountProvisioning은 이제 issued를 보고합니다. 기능 및 요구 사항을 참조하세요.
• 판매자 패널의 은행 계좌 상세 정보는 은행 로고가 포함된 드로어에서 열립니다. 계좌를 참조하세요.
• 판매자 패널은 자금 이동을 Pay in 및 Pay out으로 표시하고, 6시간 동안 로그인 상태를 유지하며, 도움 요청을 이메일로 Swipelux 지원팀에 보냅니다.
• 직접 제출을 허용하는 접수 작업에서는 고객 프로필이나 업로드된 문서로 이미 뒷받침되는 해당 요구 사항이 자동으로 in_review로 이동합니다. 기능 및 요구 사항을 참조하세요.

​

수정

• 취소된 기능의 재요청이 더 이상 대체된 신청 기록이나 오래된 요구 사항으로 인해 실패하지 않습니다.
• 폐기된 Fedwire ID로 저장된 기능이 이제 500을 반환하는 대신 wire로 조회됩니다.

​

추가

• GET /v3/customers/{customerId}/applications는 고객의 신청 건을 나열하며, 각 건에 대해 요청된 기능과 그 건의 승인이 포함하는 기능을 함께 보여줍니다. 한 은행에서의 승인 하나가 여러 기능을 포함할 수 있습니다. 보존된 과거 건은 supersededByApplicationId를 통해 후속 건을 가리킵니다. 목록은 커서 페이지네이션과 updatedAfter를 지원합니다. 기능 및 요구 사항을 참조하세요.
• POST /v3/customers/{customerId}/capabilities/{capabilityId} 응답에는 신청 건 기반 기능의 경우 selectedApplicationId가 포함됩니다. 이는 요청이 재사용한 기존 신청 건 또는 요청이 새로 연 건을 식별합니다. 기능 및 요구 사항을 참조하세요.
• GET /v3/institutions 및 지원되는 기능 목록에서 반환되는 기관에는 null일 수 있는 logoUrl이 포함됩니다. 사용 가능한 경우 은행 브랜딩을 표시하는 데 사용하고, null인 경우 기관 이름을 대신 표시하세요. 기능 및 요구 사항을 참조하세요.
• 이제 USD SWIFT 지급을 사용할 수 있습니다. SWIFT 지급에는 최소 100 USD가 필요합니다. 판매자 패널에서 수취인의 SWIFT 은행 지침을 수집합니다. 자금 지급을 참조하세요.
• 발급된 은행 계좌는 명의 지정 수취 정보를 사용해 SWIFT를 통해 자금을 받을 수 있습니다. 은행 계좌 발급을 참조하세요.
• 이제 USDT가 ACH 및 Wire 지급의 출금 소스로 지원됩니다. 자금 지급을 참조하세요.
• 발급된 은행 계좌는 USDC 또는 USDT 값의 settlement.currency를 허용하므로, 지갑 계좌 통화와 관계없이 정산 지갑으로 전달할 스테이블코인을 선택할 수 있습니다. 지갑 통화로 계속 정산하려면 생략하세요. 은행 계좌 발급을 참조하세요.
• SWIFT 은행 계좌와 수취인 목적지는 bankCity, bankState, bankPostalCode, bankAddressLine2와 함께 선택적 beneficiaryTaxId, beneficiaryPhoneNumber, ifscBranchCode, paymentCode 및 중개 은행 정보를 허용합니다. 자금 지급을 참조하세요.
• 발급된 은행 계좌 상세 정보에는 은행이 ACH와 Wire 라우팅 번호를 별도로 제공하는 경우 achRoutingNumber와 wireRoutingNumber가 포함되며, 수취 은행의 bankLogoUrl도 포함됩니다. 은행 계좌 발급을 참조하세요.
• capability.created 웹훅 이벤트에는 applicationId와 requested 또는 approval 값의 origin이 포함되므로, 직접 요청한 기능과 승인으로 포함된 기능을 구분할 수 있습니다. 웹훅을 참조하세요.
• 요구 사항 요청은 http_url, us_ssn, us_ein, bank_industry_classification 등 검증용 constraints.format을 선언할 수 있습니다. 기능 및 요구 사항을 참조하세요.

​

변경

• 판매자 패널의 은행 계좌 생성은 이제 은행 선택부터 시작하며, 은행 계좌에는 별도의 ACH 및 Wire 라우팅 번호가 표시됩니다. 계좌를 참조하세요.
• 이제 network enum에 solana가 포함됩니다. 이는 열린 enum이므로 인식하지 못하는 네트워크 값도 허용하도록 처리하세요. 계좌를 참조하세요.
• 남은 요구 사항에 직접 제출이 필요한 작업에 대해 호스팅된 인증 링크를 열면 409 verification_session_not_allowed가 반환됩니다. 대신 해당 요구 사항을 작업 제출로 제출하세요. 오류 및 재시도를 참조하세요.
• 프로비저닝이 확정되지 않은 발급 계좌를 아카이브하면 409 account_provisioning_unresolved가 반환됩니다. 프로비저닝이 확정된 후 다시 시도하세요. 오류 및 재시도를 참조하세요.
• 새 명의 지정 은행 계좌 요청은 다음 고객 새로 고침을 기다리지 않고 계좌가 생성되는 즉시 프로비저닝 대기열에 추가됩니다. 은행 계좌 발급을 참조하세요.

​

제거

• 공유(pooled) SWIFT 수취 정보는 더 이상 새 계좌에 제공되지 않습니다. 대신 명의 지정 SWIFT 수취 정보를 사용하세요. 은행 계좌 발급을 참조하세요.

​

수정

• 지급 이체 조회 시 이제 견적에 포함된 수취인이 반환됩니다.
• 기존 ACH 계좌를 아카이브한 후 ACH 계좌를 생성해도 더 이상 409가 반환되지 않으며, 아카이브된 대기 중 계좌 요청이 더 이상 계좌 슬롯을 차지하지 않습니다.
• 현지 통화 pay-in 견적의 은행 수수료가 올바른 법정화폐로 보고됩니다.

​

추가

• GET /v3/webhooks/{webhookId}는 단일 웹훅 엔드포인트와 해당 events 선택을 조회합니다. 웹훅을 참조하세요.
• 작업 요구 사항은 이제 필수 주소 필드를 포함한 프로필 필드에 대해 allowedValues와 JSON Schema valueSchema를 제공합니다. 국가 필드는 valueType 또는 itemValueType으로 country를 보고하며, 이는 ISO 3166-1 alpha-2 코드를 뜻합니다. 입력 필드와 선택지를 하드코딩하지 않고 렌더링할 수 있습니다. 기능 및 요구 사항을 참조하세요.
• 이제 기존 Tron 지갑에서 고객의 외부 지갑 계좌로 USDT를 보낼 수 있으며, 이체 조회에는 Tron 트랜잭션의 블록 탐색기 링크가 포함됩니다. Tron에서는 새 지갑을 발급할 수 없습니다. 자금 지급을 참조하세요.
• 작업 요구 사항은 requiredWhen(지정된 예/아니요 답변이 일치할 때만 응답), profileAssertion(us_person), ownershipPolicy를 선언할 수 있으며, 문서 요청은 identityMetadataRequired와 maxIssueAgeDays를 설정할 수 있습니다. 작업 답변은 참조된 문서에 대해 documentMetadata(idNumber, issuingCountry, issuedOn)를 허용하며, 작업 조회는 검토된 제어 답변을 conditionValues로 반환합니다. 기능 및 요구 사항을 참조하세요.
• 문서 요구 사항은 acceptedDocumentSets를 나열할 수 있으며, 관계자 요구 사항은 beneficial_owner 외에 associated_person 또는 control_person 자격을 요청할 수 있습니다. 기능 및 요구 사항을 참조하세요.
• 이체 correction 객체는 이제 자금이 조달된 지급의 실패도 다룹니다. recover_source_funding 보상 조치가 포함된 kind: funding_failure, unknown 또는 reported 값의 recoveryStatus, USDT로 입금된 출력이 포함됩니다. 견적 및 송금을 참조하세요.

​

변경

• PATCH /v3/webhooks/{webhookId}는 이제 엔드포인트가 이미 구독 중인 레거시 이벤트 유형을 허용하므로, v3 이벤트 유형을 추가하면서 이를 유지할 수 있습니다. events는 전체 선택을 대체하므로, 유지하려는 모든 이벤트 유형을 포함하세요. 엔드포인트에 없던 레거시 이벤트 유형을 추가하면 400 validation_error가 반환됩니다. 웹훅을 참조하세요.
• 수취인과 계좌의 은행 식별자는 저장 전에 검증됩니다. 수취인을 참조하세요.
• 기능 요청, 작업 제출, 샌드박스 상태 변경은 기능이 이전 온보딩 모델에서 생성된 경우 이제 500 대신 409 capability_application_stale을 반환합니다. 오류 및 재시도를 참조하세요.
• 공개 RFI 페이지는 이제 하나의 연속된 양식입니다. 관계자를 지원하며 개인별로 하나의 세금 ID를 수집합니다. 문서 요구 사항을 참조하세요.
• 결제 금액이 은행에서 고객의 남은 일일 또는 월간 한도를 초과하면 견적과 이체는 409 customer_bank_limit_exceeded를 반환하고, 해당 한도를 확인할 수 없으면 503 customer_bank_limits_unavailable을 반환합니다. 견적에서 지급을 시작할 수 없으면 이체는 409 payout_execution_unavailable을 반환합니다. 오류 및 재시도를 참조하세요.
• 완료된 은행 접수와 충돌하는 고객 및 관계자 업데이트는 taskId와 fields가 포함된 409 field_conflicts_with_completed_intake를 반환합니다.

​

수정

• 취소된 기능 기록은 계속 조회할 수 있습니다.
• 판매자 패널의 거래 목록에서 wire 지급이 올바르게 표시되고 필터링됩니다.

​

변경

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

​

추가

• POST /v3/transfers가 카드 견적에 대해 선택 사항인 paymentMethod(card, apple_pay 또는 google_pay)를 받아요. 요청한 방식이 고객과 고객의 기기에서 사용 가능하면 호스팅된 체크아웃이 그 방식으로 열리고, 전송 조회는 요청을 그대로 돌려주며, 견적의 금액과 수수료는 변하지 않아요. 자금 수취를 참조하세요.
• GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-preview가 institutions를 받아서, 지원되는 기능 목록에서 반환된 특정 은행에 대한 작업을 미리 볼 수 있어요. 기능 및 요구 사항을 참조하세요.

​

변경

• 카드 견적은 이제 결제 수수료와 실제 전달되는 순 USDC 금액을 반영합니다. 자금 수취를 참조하세요.
• 거부된 지급 견적은 일반적인 실패 대신 구체적인 문제 코드(quote_amount_out_of_range, quote_volume_limit_exceeded, quote_source_network_unsupported 또는 quote_failed)를 반환하며, 나중에 견적을 다시 시도할 수 있는 경우 503 quote_temporarily_unavailable을 반환합니다. 오류 및 재시도를 참조하세요.

​

수정

• 카드 견적이 더 이상 수수료 반올림으로 인해 실패하지 않습니다.
• 설문 응답에 불필요한 공백이 포함되어 있어도 호스팅 KYC 링크를 다시 열 때 더 이상 409 kyc_process_conflict가 반환되지 않습니다.
• 판매자 패널에서 멈춘 패스키 출금 확인이 이제 복구됩니다.

​

추가

• POST /v3/customers/{customerId}/documents는 이제 storageKey, fileName, type을 포함한 application/json 본문도 허용합니다. storageKey는 이전 direct-upload 플로를 통해 보관된, 아직 유효한 고객 범위 참조여야 하며, 업로드는 multipart 업로드와 동일한 크기 및 파일 시그니처 검증을 거칩니다. v3로 마이그레이션을 참조하세요.
• GET /v3/customers/{customerId}/documents/{documentId}/download는 활성 고객 문서에 대한 다운로드 url을 반환합니다. 이 URL은 1시간 후에 만료되며 파일을 첨부 파일로 제공합니다. 아카이브된 문서, 알 수 없는 문서, 다른 고객의 문서는 404를 반환합니다. 기능 및 요구 사항을 참조하세요.
• 실소유자가 없는 비즈니스에 대해 기능을 요청하면 이제 503으로 실패하는 대신 실소유자를 추가하기 위한 접수 작업이 생성됩니다. 진행할 수 없는 요청은 신고된 소유권 또는 25% 이상의 소유권을 가진 개인 관계자를 추가하라는 안내와 함께 422 beneficial_owner_required를 반환합니다. 주주, UBO, 통제 담당자를 참조하세요.
• 판매자 패널의 작업 테이블에 이제 각 요청의 대상과 기능 범위가 표시되어, 규정 준수 요청이 누구와 무엇을 대상으로 하는지 확인할 수 있습니다. 기능 및 요구 사항을 참조하세요.
• 판매자 패널의 업종 분류 필드는 이제 고객 프로필과 요구 사항 작업에서 검색 가능한 NAICS 코드를 제공합니다. KYB 워크플로를 참조하세요.
• 은행 pay-in 지침에 bankName, bankAddress, accountHolderName, accountHolderAddress가 포함될 수 있습니다. 다른 은행 정보와 함께 표시하세요. 자금 수취를 참조하세요.
• POST /v3/transfers는 카드 또는 Apple Pay 호스팅 결제 후 고객을 앱으로 되돌려 보내는 선택적 redirectUrl을 허용합니다. URL에 도달했다고 해서 완료가 확인되는 것은 아니므로, 이체 조회나 웹훅을 사용하세요. 자금 수취를 참조하세요.
• v3 Rule로 생성된 이체는 이체 조회 및 목록에 origin: rule로 표시되며, 다른 이체와 마찬가지로 transfer.state_changed 이벤트를 발생시킵니다. GET /v3/transfers?origin=rule로 필터링하세요. 견적 및 송금을 참조하세요.
• 고객 및 관계자의 신원 문서는 sideApplicability(front_only, front_and_back 또는 unknown)를 허용하며, 작업은 type, number, issuingCountry, issuingRegion, issuedOn, expiresOn, doesNotExpire 등 신원 문서 세부 정보를 답변으로 수집할 수 있습니다. 기능 및 요구 사항을 참조하세요.

​

변경

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

​

제거

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

​

수정

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

​

추가

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

​

변경

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

​

제거

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

​

수정

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

​

추가됨

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

​

변경됨

• 고객 및 계좌의 국가 코드는 쓰기 시점에 할당된 ISO 3166-1 alpha-2 값으로 검증됩니다. 읽기는 레거시 저장 값을 허용하므로, 기존 레코드는 계속 해석됩니다. 계좌와 지갑을 참조하십시오.
• USDC 가용성은 이제 목적지 네트워크에 따라 범위가 지정되므로, 견적과 전송은 목적지가 실제로 지원하는 네트워크에서만 USDC를 제공합니다.
• 이제 모든 온보딩 플로우에 Swipelux 서비스 약관이 필요합니다. 기존 세션은 계속 재개할 수 있습니다. 고객 온보딩을 참조하십시오.
• Capability.ready는 계속해서 권한 승인을 나타냅니다. 계좌 발급을 not_applicable, not_started, in_progress, issued, failed로 추적하려면 accountProvisioning을 사용하십시오. 기능 및 요구 사항을 참조하십시오.
• iPhone에서 업로드된 HEIC 파일이 신원 및 주소 증명 서류로 이제 허용됩니다.
• 진행 중인 태스크가 여전히 요구하는 고객 또는 관계자 필드를 비우면 이제 재시도 가능한 충돌 대신 차단 중인 taskId와 fields가 포함된 409 field_required_by_open_task를 반환합니다. 해당 필드를 변경하기 전에 태스크를 완료하거나 취소하십시오. 오류 및 재시도를 참조하십시오.

​

수정됨

• 이미 소비된 견적을 재실행하면 일반 오류가 아닌 409 quote_execution_consumed을 반환합니다. 견적과 전송을 참조하십시오.
• 전송 목록 읽기와 견적 금액 읽기가 대규모 과거 결과에서 더 이상 500 오류를 발생시키지 않습니다.
• 동시 KYC 리디렉션이 이제 404 대신 충돌을 반환하여 재시도가 깔끔하게 해결됩니다. 호스팅된 리디렉션이 더 이상 중간에 롤백되지 않으며, KYC 링크는 계속 재개할 수 있습니다.
• 개인 고객에 대한 관계자 읽기가 더 이상 404를 반환하지 않습니다.
• 잘못된 지갑 필드가 있는 KYB 제출은 제출 전에 거부되며, 실패한 동기화가 더 이상 머천트 패널에서 성공으로 보고되지 않습니다.
• 머천트 패널의 요구 사항 태스크가 이제 제출된 응답을 완료로 표시하고, 약관 작업을 별도로 추적하며, 중복된 문서 텍스트를 제거하고, 시작된 KYC 세션을 완료될 때까지 대기 중으로 유지하며, 오래된 태스크를 요구 사항 뷰를 깨뜨리지 않고 처리합니다.
• 머천트 패널의 검증 링크 행에서 모든 행에 Open 액션이 표시되고, 모든 태스크 링크가 요구 사항 뷰에 렌더링됩니다.