Skip to main content
Transfers API를 사용하면 송금하고, 지급 가능한 수취인을 찾고, 자금 이동을 대사할 때 이체 목록을 조회하거나 개별 이체를 조회하고, 수령 링크를 미리 보거나 수령할 수 있습니다. 결과를 폴링하는 대신 transfer.completed 및 transfer.failed를 구독하세요. 참여하는 각 계정은 이 이벤트를 구독할 수 있습니다. transfer.created도 처리가 시작될 때가 아니라 성공 시에 발생합니다. 실패한 이체는 동일한 ID로 재시도되어 나중에 성공할 수 있으므로, 이체를 조회하여 현재 상태를 대사하세요. 성공한 잔액 이체는 릴리스 날짜가 적용되지 않는 한 수취인의 사용 가능 잔액에 입금됩니다. 대기 중 잔액에서 충당된 이체는 릴리스 날짜를 유지하며 대기 중 잔액에 입금됩니다. 해당되는 수취인 준비금이나 사기 방지 보류로 인해 자금을 사용할 수 없는 상태가 유지될 수 있습니다. succeeded는 이체가 완료되었음을 확인할 뿐, 모든 자금을 출금할 수 있음을 의미하지는 않습니다.

엔드포인트

속성

string
필수
이체 ID입니다.
object | null
필수
수취인에게 입금된 금액입니다. 이체가 성공하기 전까지는 null입니다.

속성

string
필수
주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
string
필수
이체가 생성된 시각입니다.
object | null
필수
이체를 받는 비즈니스 계정 또는 사용자입니다.

속성

string
필수
계정 또는 사용자 ID입니다.
string | null
필수
비즈니스 로고 또는 사용자 아바타 URL입니다. 사용 가능한 이미지가 없으면 null입니다.
string | null
필수
비즈니스 또는 사용자 표시 이름입니다.
string
필수
프로필이 비즈니스 계정인지 사용자인지 여부입니다.사용 가능한 옵션: account, user
string | null
필수
기록된 실패 시각입니다. 이체가 실패한 경우가 아니면 null입니다.
string | null
필수
기계가 읽을 수 있는 실패 코드입니다. 이체가 실패한 경우가 아니면 null입니다.
string | null
필수
실패 설명입니다. 이체가 실패한 경우가 아니면 null입니다.
object | null
필수
플랫폼 마크업을 포함한 적용 가능한 모든 이체 수수료입니다. 권위 있는 합계를 사용할 수 없으면 null입니다.

속성

string
필수
주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
object
필수
이체에 첨부된 사용자 정의 메타데이터입니다.
string | null
필수
이체 메모입니다.
string
필수
객체 유형입니다.
object | null
필수
이체를 보내는 비즈니스 계정 또는 사용자입니다.

속성

string
필수
계정 또는 사용자 ID입니다.
string | null
필수
비즈니스 로고 또는 사용자 아바타 URL입니다. 사용 가능한 이미지가 없으면 null입니다.
string | null
필수
비즈니스 또는 사용자 표시 이름입니다.
string
필수
프로필이 비즈니스 계정인지 사용자인지 여부입니다.사용 가능한 옵션: account, user
string
필수
현재 이체 상태입니다. 이체는 processing 상태로 생성된 뒤 몇 초 후에 정산될 수 있습니다. 생성 응답을 최종 결과로 간주하지 말고, Retrieve Transfer를 폴링하거나 transfer.completed 및 transfer.failed 웹훅을 수신하세요. succeeded와 failed는 최종 상태입니다.사용 가능한 옵션: processing, succeeded, failed
string | null
필수
현재 상태 전환이 기록된 시각입니다. 과거 전환 시각을 알 수 없으면 null입니다.
string | null
필수
기록된 성공 시각입니다. 알 수 없으면 null입니다.
string
필수
이체 추적 페이지입니다. 보려면 로그인과 해당 이체에 대한 접근 권한이 필요합니다.
Transfer