우시페이는 은행 계좌로 대금을 지급할 수 있습니다. 대시보드에서 은행 계좌의 모든 지급금 목록을 확인할 수 있습니다. 또한 API를 통해 지급 목록을 검색할 수도 있습니다.
지급 상태 #
하나의 지급 요청에는 다섯 가지 상태가 있습니다. 지급이 생성되면 초기 상태는 보류 중입니다. 취소 API가 호출되면 상태가 취소되어 지급 프로세스가 취소됩니다. 요청이 은행에 제출되면 상태는 전송 중으로 바뀝니다. 은행 처리가 실패하면 지급 결과의 실패로 이어지고, 은행 처리가 성공하면 지급 상태로 이어집니다.
지급 속도 #
지급 일정은 자금이 지급되는 주기(예: 요일)를 의미하지만, 지급 속도는 자금을 사용할 수 있게 되는 데 걸리는 시간을 의미합니다. 지급 속도는 국가마다 다르며 일반적으로 T+X일로 표시됩니다. 일부 결제 처리업체는 내부 정산 시간, 즉 자금이 은행 계좌에 입금되는 시점부터 "T"를 시작할 수 있습니다.
"T"는 거래 시간을 의미하며, 최초 결제 확인 또는 캡처 시간을 의미합니다. 예를 들어, 계정이 표준 지급 속도가 T+3인 국가에 있고 수동 지급 일정을 사용하는 경우, 결제를 캡처한 시점으로부터 영업일 기준 3일 이내에 잔액을 지급받을 수 있습니다.
최소 지급 금액 #
최소 지급 금액은 일반적으로 현지 통화의 기본 단위입니다. 예를 들어 미국에서는 최소 지급액이 1달러인 반면 싱가포르에서는 최소 지급액이 1싱가포르 달러입니다.
지급 속도 및 최소 금액 #
국가/지역 | 지급 속도(영업일) | 최소 금액(현지 통화) | 최대 금액(현지 통화) |
---|---|---|---|
홍콩 | 1-3 | 0.01 HKD | / |
일본 | 1-3 | 100.00 JPY | / |
대한민국 | 1-3 | 1.00 KRW | / |
유럽연합(단일 유로 결제 지역) | 1-3 | 0.01 EUR | / |
영국 | 1-3 | 0.01 GBP | / |
미국 | 1-3 | 0.01 USD | / |
뉴질랜드 | 1-3 | 0.01 NZD | / |
호주 | 1-3 | 0.01 AUD | / |
말레이시아 | 1-3 | 1.00 MYR | / |
싱가포르 | 1-3 | 0.01 SGD | / |
대한민국 | 1-3 | 1 원 | / |
태국 | 1-3 | 10 THB | 500000 THB |
베트남 | 1-3 | 10000 VND | 300000000 VND |
필리핀 | 1-3 | 10 PHP | 500000 PHP |
인도네시아 | 1-3 | 10000 IDR | 1000000000 IDR |
중국 본토 | 1-3 | 300 CNY | / |
위 표는 표준 사례입니다. 지급 속도는 은행마다 다를 수 있으며 며칠이 더 걸릴 수도 있습니다. 비즈니스 유형과 거주 국가도 지급 시점에 영향을 미칠 수 있습니다.
지급 시작 #
우시페이 API로 지급금을 생성할 수 있습니다. 일반적으로 지급액에는 두 가지 시나리오가 있습니다.
- 글로벌 지급금
- 중국으로의 지급금
지급액을 생성하기 전에 지정해야 하는 몇 가지 필수 매개변수가 있습니다:
수혜자
: 수취인 세부 정보는 초기 지급금인 경우 이 객체에 제공해야 합니다.수혜자_ID
는 사용되지 않습니다. ) .유형
: 유형은 다음 중 하나여야 합니다.비즈니스
(회사용) 또는수취인
(개인용)비즈니스
: 다음을 포함한 비즈니스 세부 정보가 필요합니다.회사_등록_이름
,주소
그리고추가_정보
.수취인
: 다음을 포함한 비즈니스 세부 정보가 필요합니다.주소
,추가_정보
.목적지
: 지급금이 송금된 은행 계좌 또는 카드 정보가 필요합니다.
글로벌 지급금 #
글로벌 지급액 생성
수취인 정보를 직접 제공하여 새로운 글로벌 지급금을 생성하려면 다음과 같이 하세요.
회사 요청의 경우
{
"수혜자_데이터": {
"type": "business",
"business": {
"회사_등록_이름": "XXX ltd",
"주소": {
"line1": "블록 3A",
"line2": "XX Park",
"postal_code": "98109",
"도시": "Seattle",
"state": "WA",
"국가": "USA"
},
"additional_info": {
"사업자등록번호": "32342353535334234MCA4",
"legal_rep_first_name": "Ming",
"legal_rep_last_name": "Zhang",
"legal_rep_id_type": "NATIONAL_ID",
"legal_rep_id_number": "233923874838920238X",
"legal_rep_email": "xxx@email.com",
"legal_rep_phone": "13727282938"
}
}
},
"금액": 666,
"통화": "cny",
"description": "여기에 설명을 추가할 수 있습니다."
"type": "은행 계좌",
"destination_data": {
"source": {
"계좌_소유자_이름": "XXXX LTD",
"account_holder_type": "회사",
"bank_name": "뱅크 오브 아메리카",
"국가": "USA",
"통화": "USD",
"계좌번호": "6210000000000002"
}
}
}
응답
{
"id": "po_1654453881670729728",
"object": "payout",
"created": 1683287519000,
"통화": "CNY",
"금액": 666,
"description": "여기에 설명을 추가할 수 있습니다.",
"status": "보류 중",
"destination": {
"id": "ba_1654453883419754496",
"object": "bank_account",
"created": 1683287519000,
"country": "USA",
"통화": "USD",
"fingerprint": "817902e3b6a2cf61eebc484f89467be650063413",
"last4": "0002",
"계정_소유자_이름": "XXXX LTD",
"계정_소유자_유형": "company"
},
"livemode": false,
"type": "은행_계좌",
"method": "standard",
"수혜자": {
"id": "bf_1654453881691701248",
"object": "수혜자",
"type": "비즈니스",
"business": {
"주소": {
"도시": "Seattle",
"국가": "USA",
"line1": "블록 3A",
"line2": "XX Park",
"state": "WA",
"postal_code": "98109"
},
"회사_등록_이름": "XXX ltd",
"추가_정보": {
"사업자등록번호": "32342353535334234MCA4",
"legal_rep_first_name": "Ming",
"legal_rep_last_name": "Zhang",
"legal_rep_id_type": "NATIONAL_ID",
"legal_rep_id_number": "233923874838920238X",
"legal_rep_email": "xxx@email.com",
"legal_rep_phone": "13727282938"
}
}
}
}
개별 요청의 경우
수취인 정보를 직접 제공하여 지급금을 생성하려면 다음과 같이 하세요.
{
"수혜자_데이터": {
"type": "수취인",
"수취인":{
"주소": {
"line1": "### Ave",
"line2": "#501",
"postal_code": "98109",
"city": "Seattle",
"state": "WA",
"국가": "USA"
},
"additional_info": {
"last_name":"Kale",
"first_name":"레오",
"id_type":"NATIONAL_ID",
"id_country_iso_code":"미국",
"id_number":"234242423423434X",
"email":"xxx@email.com",
"phone":"1234534343"
}
}
},
"금액": 1000,
"currency": "USD",
"description": "여기에 설명을 추가할 수 있습니다."
"type": "은행 계좌",
"destination_data": {
"source": {
"account_holder_name": "레오 케일",
"account_holder_type": "개인",
"bank_name": "뱅크 오브 아메리카",
"국가": "USA",
"통화": "USD",
"계좌번호": "6210000000000002"
}
}
}
응답
{
"id": "po_1654455721024028672",
"object": "payout",
"created": 1683287958000,
"통화": "USD",
"금액": 1000,
"description": "여기에 설명을 추가할 수 있습니다."
"status": "보류 중",
"destination": {
"id": "ba_1654455722777247744",
"object": "bank_account",
"created": 1683287957000,
"country": "USA",
"통화": "USD",
"fingerprint": "3e27cccbe614f34d9b688b9eed46cea1cf9eee1d",
"last4": "0002",
"계정_소유자_이름": "레오 케일",
"account_holder_type": "개인"
},
"livemode": false,
"type": "은행_계좌",
"method": "standard",
"수혜자": {
"id": "bf_1654455721040805888",
"object": "수혜자",
"type": "수취인",
"수취인": {
"주소": {
"도시": "Seattle",
"국가": "USA",
"line1": "### Ave",
"line2": "#501",
"state": "WA",
"postal_code": "98109"
},
"additional_info": {
"이메일": "xxx@email.com",
"phone": "1234534343",
"name": "레오케일",
"last_name": "Kale",
"first_name": "레오",
"id_type": "NATIONAL_ID",
"id_country_iso_code": "USA",
"id_number": "234242423423434X"
}
}
}
}
정기 지급
수취인에게 이미 지급한 적이 있는 경우 다음을 사용하여 지급을 생성할 수 있습니다. 수혜자_ID
, 대상_id
서버에 저장되며 마지막 응답에서 찾을 수 있습니다.
위의 경우, 수혜자_ID
is "bf_1579357548861980672"
그리고 대상_id
is "ba_1654455722777247744"
요청
{
"수혜자": "bf_1579357548861980672",
"금액": 888,
"통화": "USD",
"description": "여기에 설명을 추가할 수 있습니다.",
"type": "은행 계좌",
"destination": "ba_1654455722777247744"
}
중국으로의 지급금 #
중국으로 새 지급액 생성
글로벌 지급액과의 차이점은 다음과 같이 제출해야 한다는 것입니다. 결제_인텐트_ID
를 입력하세요.
요청
{
"수혜자": "bf_1579357548861980672",
"금액": 666,
"통화": "cny",
"설명": "여기에 설명을 추가할 수 있습니다."
"type": "은행 계좌",
"destination_data": {
"source": {
"계좌_소유자_이름": "XXXX LTD",
"account_holder_type": "회사",
"bank_name": "중국 은행",
"국가": "CN",
"통화": "CNY",
"계좌번호": "6210000000000002"
}
},
"payment_intents_id": [
"pi_1577840204872417280"
]
}
규정 준수 문서로 지급금 생성
규정 준수 문서를 제출해야 하는 경우, 규정 준수 문서로 지급금을 생성하는 세 단계가 있습니다.
- 파일 만들기를 사용하여 규정 준수 문서를 업로드합니다.
요청
curl --location --request POST 'https://apitest.wooshpay.com/v1/files' \.
--header 'Accept: application/json' \.
--header 'Authorization: 당신의 키' \
--header 'User-Agent: Apifox/1.0.0' \.
--form 'file=@"/路径/xxx.pdf"''
응답
{
"id": "file_1654416327596572672",
"object": "파일",
"created": 1683278565516,
"url": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf",
"type": "pdf",
"파일명": "1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
}
- 복사 URL on 귀하의 응답 위의 경우에는
URL
ishttps://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf
- 신청하기
메타데이터
생성된 지급액에
메타데이터
: 두 부분으로 구성되어 있으며 첫 번째 부분은키
그리고 두 번째 부분은값
.- 예:
"메타데이터": { "규정 준수 문서": "문서 URL", "key2": "value2", "...": "..." }
요청
{
{
"수혜자": "bf_1579357548861980672",
"메타데이터": {
"규정 준수 문서": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
},
"금액": 666,
"통화": "cny",
"설명": "여기에 설명을 추가할 수 있습니다."
"type": "은행 계좌",
"destination_data": {
"source": {
"계좌_소유자_이름": "XXXX LTD",
"account_holder_type": "회사",
"bank_name": "중국 은행",
"국가": "CN",
"통화": "CNY",
"계좌번호": "6210000000000002"
}
},
"payment_intents_id": [
"pi_1577840204872417280"
]
}
}
응답됨
{
"id": "po_1654421512435793920",
"object": "payout",
"created": 1683279802000,
"통화": "CNY",
"금액": 666,
"description": "여기에 설명을 추가할 수 있습니다.",
"메타데이터": {
"컴플라이언스 문서": "https://oss.swooshtransfer.cn/oa/product/1654416327596572672_9gKPHbFsa5pUq47TafAMfVvJ.pdf"
},
"status": "보류 중",
"destination": {
"id": "ba_1654421514230956032",
"object": "bank_account",
"created": 1683279801000,
"country": "CN",
"통화": "CNY",
"지문": "4732b34681776e6b2383da452cbbabbcd2228d48",
"last4": "0002",
"계정_소유자_이름": "XXXX LTD",
"계정_소유자_유형": "company"
},
"livemode": false,
"type": "은행_계좌",
"method": "standard",
"수혜자": {
"id": "bf_1654421512456765440",
"object": "수혜자",
"type": "비즈니스",
"business": {
"주소": {
"도시": "베이징",
"국가": "CN",
"line1": "블록 3A",
"line2": "XX Park",
"state": "베이징",
"postal_code": "323111"
},
"회사_등록_이름": "XXX ltd",
"additional_info": {
"사업자등록번호": "32342353535334234MCA4",
"legal_rep_first_name": "Ming",
"legal_rep_last_name": "Zhang",
"legal_rep_id_type": "NATIONAL_ID",
"legal_rep_id_number": "233923874838920238X",
"legal_rep_email": "xxx@email.com",
"legal_rep_phone": "13727282938"
}
}
},
"payment_intents_id": [
"pi_1577840204872417280"
]
}
지급 실패 #
어떤 이유로든 은행 계좌에서 지급금을 수령할 수 없는 경우 은행은 해당 금액을 당사로 반송합니다. 그러면 실패 사유와 함께 오류가 반환됩니다. 은행에서 지급금을 반환하고 지급 실패 사실을 알려주는 데 영업일 기준 며칠이 걸릴 수 있습니다. 이 경우 대시보드에서 알림을 받게 됩니다. 제공한 은행 계좌 정보가 정확한지 확인하세요. 정확하지 않은 경우(예: 계좌 번호에 오타가 있는 경우) 다른 은행 계좌 소유자에게 지급금이 지급될 수 있습니다.
마이너스 지급금 #
각 지급액에는 지급액이 생성될 당시의 사용 가능한 계정 잔액이 반영됩니다. 경우에 따라 계정 잔액이 마이너스일 수도 있습니다. 예를 들어, 지급액 100달러를 수령하고 이전 지급액 200달러를 환불하는 경우 계정 잔액은 -100달러가 됩니다. 마이너스 금액의 균형을 맞추기 위해 추가 지급을 받지 못하면 새로운 지급이 실패합니다.
지급 결과에 대해 알아보기 #
은행 계좌로 지급이 성공했는지 확인하려면 웹훅을 설정해야 합니다.
다음 이벤트 유형은 은행 계좌로 지급할 때 중요하며, 웹훅을 생성하여 지급 상태를 확인할 수 있습니다.
payout.취소됨
: 지급이 취소될 때마다 발생합니다.payout.created
: 지급액이 생성될 때마다 발생합니다.payout.failed
: 지급 시도가 실패할 때마다 발생합니다.payout.paid
: 대상 계정에서 지급이 가능할 것으로 예상될 때마다 발생합니다. 지급이 실패하면 나중에 지급 실패 알림도 전송됩니다.payout.updated
: 지급액이 업데이트될 때마다 발생합니다.
모니터링할 이벤트를 식별한 후에는 웹훅 가이드를 참조하여 다음과 같이 할 수 있습니다. 웹훅 만들기.
즉시 지급 #
즉시 지급을 사용하면 지원되는 은행 계좌(영국)로 자금을 송금하면 하루 이내에 처리할 수 있습니다. 주말과 공휴일을 포함하여 언제든 즉시 지급을 요청할 수 있으며, 일반적으로 연결된 은행 계좌에 자금이 입금됩니다.
국가/지역 | 지급 속도(영업일) | 최소 금액(현지 통화) |
---|---|---|
영국 | 0 | 0.01 GBP |