수취인 등록

post

https://sandbox-api.sentbiz.com/v2/receivers

송금시 필요한 수취인의 정보를 등록합니다.

응답시 나오는 수취인의 Unique ID를 송금 신청에 활용할 수 있습니다.

Request parameter 항목들의 필수여부는 수취국가(destination_country) 및 수단(method_type)에 따라 다를수 있습니다.

수취 국가(destination_country) 및 수단(method_type)에 따른 필수 항목 정보는 필수 파라미터 확인 페이지 를 참고해주세요.

[매핑 참고] 본 API 필드명: 필수 파라미터 확인 페이지 컬럼명
- destination_country = Country - ISO Code
- method_type = Method Type

Request parameter 항목들 중 필수(Required) 표기된 항목들은 수취국가 및 수단에 상관없이 공통적으로 필수인 항목들 입니다.

필수 파라미터 확인 페이지 에서 확인된 필수 항목이 누락될 경우 수취인 등록이 불가합니다. (에러 응답 수신)

수취 국가(destination_country), 수취 통화(destination_currency), 별 사용 가능한 수단(method_type), 수취 기관코드( destination_institution_code) 확인은 수취 수단 조회 API 를 사용하여 확인해주세요.

[매핑 참고] 본 API 필드명: 수취 수단 조회 API 필드명
- destination_country = country
- destination_currency = currency
- method_type = method
- destination_institution_code = institution_code

수취 수단 조회 API 에서 확인되지 않은 정보 전송시 에러가 발생하여 수취인 등록이 불가합니다. (에러 응답 수신)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

type

string

enum

required

수취인 타입

Allowed:

first_name_english

string

required

length ≤ 100

영문 이름 (type 이 INDIVIDUAL 일 때)

또는 영문 기업명 (type 이 COMPANY 일 때)

middle_name_english

string

length ≤ 100

영문 중간 이름

last_name_english

string

required

length ≤ 100

영문 성

date_of_birth

string

생년월일

Format: YYYY-MM-DD

city

string

required

length ≤ 100

거주 도시

state

string

required

length ≤ 100

거주 주/도

region

string

required

length ≤ 100

거주 지역

country

string

required

length ≤ 2

국가 코드

Two-letter ISO 3166-1 ALPHA-2 code for the country. (ex. KR, US, CN, …)

nationality

string

required

length ≤ 2

국적 코드

Two-letter ISO 3166-1 ALPHA-2 code for the country. (ex. KR, US, CN, …)

address_line1

string

required

length ≤ 500

주소 1 (ex. 도로명 주소)

address_line2

string

length ≤ 500

주소 2 (ex. 건물명, 동호수 등)

address_line3

string

length ≤ 500

주소 3 (ex. 참고사항 등)

postcode

string

required

length ≤ 10

우편번호

device_country_code

string

required

length ≤ 2

휴대전화 국가 코드

Two-letter ISO 3166-1 ALPHA-2 code for the country. (ex. KR, US, CN, …)

phone_country_code

string

required

length ≤ 8

휴대전화 국가번호 (ex. 82, 1, 86, …)

phone_number

string

required

length ≤ 100

전화번호

string

length ≤ 200

이메일

identification_type

string

enum

신분증 타입

KR_REG: 한국 주민등록증
KR_AL_REG: 한국 외국인등록증
PASSPORT: 여권
KR_DRIVER: 한국 운전면허증
KR_BANK: 한국 은행
KYC: 한국 KYC
KR_BIZ_REG: 한국 사업자등록번호
NATIVE_REG: 해외 신분증
ID_DRIVER: 인도네시아 운전면허증
SG_NRIC: 싱가폴 NRIC
SG_FIN: 싱가폴 FIN
ID_KTP: 인도네시아 KTP
KITAS: 인도네시아 KITAS
US_DMV_DRIVER: 미국 DMV 운전면허증
US_DMV_ID: 미국 DMV 신분증

identification_value

string

length ≤ 50

신분증 번호

identification_issuer

string

length ≤ 50

신분증 발급처

identification_issue_date

string

신분증 발급일

format: yyyy-MM-dd

identification_expiration_date

string

신분증 만료일

format: yyyy-MM-dd

reference_id

string

required

length ≤ 50

고객사에서 사용하는 관리번호

pay_out_purpose_code

string

enum

required

송금 목적 코드

Allowed:

destination_country

string

required

length ≤ 2

수취 국가

Two-letter ISO 3166-1 ALPHA-2 code for the country. (ex. KR, US, CN, …)

destination_currency

string

required

length ≤ 3

수취 통화

Three-letter ISO 4217 code. (ex. KRW, USD, …)

method_type

string

enum

required

수취 수단 타입

Allowed:

method_value

string

length ≤ 50

수취 수단 번호

destination_institution_code

string

required

length ≤ 50

수취 기관 코드

account_type

string

enum

계좌 타입

SAVING: 저축계좌
CURRENT: 경상계좌
CHECKING: 일반 예금계좌
INDIVIDUAL: 개인계좌
COMPANY: 법인계좌

Allowed:

bank_branch_code

string

length ≤ 9

은행 지점 코드

bank_branch_name

string

length ≤ 100

은행 지점명

iban

string

length ≤ 34

IBAN

bic_swift

string

length ≤ 11

SWIFT

corresponding_bic_swift

string

length ≤ 11

중개은행 SWIFT

bsb_code

string

length ≤ 6

BSB code

ifsc

string

length ≤ 11

IFSC code

routing_number

string

length ≤ 9

Routing number

sort_code

string

length ≤ 6

Sort code

transit_code

string

length ≤ 5

Transit code

Response

200OK