해외 송금 내역 정정

한국은행에 이미 제출한 송금 내역의 정보를 수정 요청한다

송금정보(송금일시, 송금액, 계좌 등)와 수취인 정보 수정 가능)
송금인(송금 누적액 계좌) 수정이 필요하면 기존 거래를 퇴결처리하고 신규로 제출해야 함

보안통신흐름

해외 송금 내역 정정 API는 PUT 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

요청메시지 URL
요청메시지 URL 표
HTTP URL/api/oris/v1/agencies/{agencyId}/remittances/{businessMessageIdentifier}
HTTP MethodPUT
Content-Typeapplication/json; charset=UTF-8
요청 메시지 명세
요청 메시지 명세
HTTP항목TYPE(길이)필수값설명
HeaderAuthorizationstringYBearer <access_token>로그인 시
ORIS로부터 전송받은
access_token을
HTTP Header에 추가
[scope = inquiry]
Parameter[inpath] agencyIdstring(26)Y01JPPEG5B48T1JFNJ895GHJZRZ참가기관ID
[inpath] businessMessageIdentifierstring(21)Y202412161004000000000송금 일련번호
Bodyremittance

object

Y

-

송금 정보
remittance.remittanceBankStoreCode

string(7)

N

0010036

송금 은행 지급 점포 코드(GIRO 코드)
remittance.userAccount

string(100)

N

1231-4564-754525231

송금 계좌(무통장 입금과 같이 송금 계좌가 존재하지 않는 경우는 입력하지 않아도 됩니다.)
remittance.requestDate

string(date-time)

Y

2025-06-30T18:02:56.303340+09:00

요청 일시
remittance.amount

number

Y

1000

송금 금액
remittance.currency

string(10)("NONE" | "ADP" | "AEA" | "AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "AON" | "AOR" | "ARS" | "ATS" | "AUD" | "AWG" | "AZM" | "AZN" | "BAM" | "BBD" | "BDT" | "BEF" | "BGL" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYB" | "BYN" | "BYR" | "BZD" | "CAD" | "CHF" | "CLF" | "CLP" | "CNH" | "CNY" | "COP" | "CRC" | "CUP" | "CVE" | "CYP" | "CZK" | "DEM" | "DJF" | "DKK" | "DOP" | "DZD" | "ECS" | "ECV" | "EEK" | "EGP" | "ESP" | "ETB" | "EUR" | "FIM" | "FJD" | "FKP" | "FRF" | "GAF" | "GBP" | "GEL" | "GHC" | "GHS" | "GIP" | "GMD" | "GNF" | "GRD" | "GTQ" | "GWP" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "IEP" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "ITL" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LTL" | "LUF" | "LVL" | "LYD" | "MAD" | "MDL" | "MGA" | "MGF" | "MKD" | "MMK" | "MNT" | "MOP" | "MRO" | "MTL" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZM" | "MZN" | "NAD" | "NGN" | "NIO" | "NLG" | "NOK" | "NPR" | "NZD" | "OMR" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PTE" | "PYG" | "QAR" | "ROL" | "RON" | "RSD" | "RUB" | "RUR" | "RWF" | "SAR" | "SBD" | "SCR" | "SDD" | "SDG" | "SEK" | "SGD" | "SHP" | "SIT" | "SKK" | "SLL" | "SOS" | "SRD" | "SRG" | "STD" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMM" | "TMT" | "TND" | "TOP" | "TPE" | "TRL" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "UYU" | "UZS" | "VEB" | "VEF" | "VES" | "VND" | "VUV" | "WST" | "XAF" | "XCD" | "XDR" | "XOF" | "XPF" | "YER" | "YUM" | "ZAR" | "ZMK" | "ZMW" | "ZRN" | "ZWD")

Y

JPY

송금 통화
remittance.usdExchangeRate

number

Y

1000

USD환산환율
remittance.usdExchangeAmount

number

Y

1000

USD환산금액
remittance.justificationId

integer(int32)

Y

1

송금 사유 ID
remittance.description

string(1000)

N

고객에게 송금 한도 초과 안내 후 송금 실행

송금 메모
receiver

object

Y

-

수취인 정보
receiver.receiverName

string(100)

Y

니노미야 카즈나리

수취인명
receiver.receiverCountry

string(10)("NONE" | "A1" | "A2" | "A3" | "AD" | "AE" | "AF" | "AG" | "AI" | "AL" | "AM" | "AN" | "AO" | "AQ" | "AR" | "AS" | "AT" | "AU" | "AW" | "AX" | "AZ" | "B1" | "B2" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BM" | "BN" | "BO" | "BR" | "BS" | "BT" | "BV" | "BW" | "BY" | "BZ" | "C1" | "CA" | "CC" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "CS" | "CU" | "CV" | "CW" | "CX" | "CY" | "CZ" | "D1" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "E1" | "EC" | "EE" | "EG" | "EH" | "ER" | "ES" | "ET" | "EU" | "FI" | "FJ" | "FK" | "FM" | "FO" | "FR" | "GA" | "GB" | "GD" | "GE" | "GF" | "GG" | "GH" | "GI" | "GL" | "GM" | "GN" | "GP" | "GQ" | "GR" | "GS" | "GT" | "GU" | "GW" | "GY" | "HK" | "HM" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IM" | "IN" | "IO" | "IQ" | "IR" | "IS" | "IT" | "JE" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KR" | "KW" | "KY" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MG" | "MH" | "MK" | "ML" | "MM" | "MN" | "MO" | "MP" | "MQ" | "MR" | "MS" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NC" | "NE" | "NF" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PF" | "PG" | "PH" | "PK" | "PL" | "PM" | "PN" | "PR" | "PS" | "PT" | "PW" | "PY" | "QA" | "RE" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SH" | "SI" | "SJ" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SX" | "SY" | "SZ" | "T1" | "T2" | "T3" | "T4" | "T5" | "T6" | "T7" | "T8" | "T9" | "TC" | "TD" | "TF" | "TG" | "TH" | "TJ" | "TK" | "TL" | "TM" | "TN" | "TO" | "TP" | "TR" | "TT" | "TV" | "TW" | "TZ" | "UA" | "UG" | "UM" | "US" | "UY" | "UZ" | "VA" | "VC" | "VE" | "VG" | "VI" | "VN" | "VU" | "WF" | "WS" | "XK" | "YE" | "YT" | "YU" | "Z1" | "ZA" | "ZM" | "ZR" | "ZW" | "ZZ")

Y

JP

수취인 국가
receiver.receiverAgency

string(100)

N

해송은행

수취(중계)기관(제휴기관)
receiver.receivingMethod

string("SWIFT" | "캐쉬픽업" | "카드결제망" | "기타")

N

SWIFT

수취방식
receiver.receivingIdentificationNumber

string(100)

N

d3b07384-d9a0-4fd3-a3fa-567089efc1c0

수취식별번호
요청 메시지 형태
{
  "remittance": {
    "remittanceBankStoreCode": "0010036",
    "userAccount": "1231-4564-754525231",
    "requestDate": "2025-06-30T18:02:56.303340+09:00",
    "amount": 1000,
    "currency": "JPY",
    "usdExchangeRate": 1000,
    "usdExchangeAmount": 1000,
    "justificationId": 1,
    "description": "고객에게 송금 한도 초과 안내 후 송금 실행"
  },
  "receiver": {
    "receiverName": "니노미야 카즈나리",
    "receiverCountry": "JP",
    "receiverAgency": "해송은행",
    "receivingMethod": "SWIFT",
    "receivingIdentificationNumber": "d3b07384-d9a0-4fd3-a3fa-567089efc1c0"
  }
}
응답 메시지 명세
요청 메시지 명세
HTTP항목TYPE(길이)필수값설명
BodybusinessMessageIdentifier

string(21)

Y

202412161004000000000

송금 일련번호 : 참가기관이 발급한 모든 요청별 고유한 송금 일련번호({날짜+참가기관코드+일련번호9자리숫자})
userId

string(26)

Y

01JR9JH2S5SG85EJDZK4XYXBV4

송금인 ID
accountId

string(26)

Y

01JR9JHJSJQEREHWPCTB0XH2M5

송금인 누적액 계좌ID
accumulatedAmountTotal

number

Y

21870

송금인 총 누적액(경상,자본 USD환산금액 합계)
accumulatedAmountCurrent

number

Y

10870

송금인 경상거래 누적액(USD환산금액)
accumulatedAmountCapital

number

Y

11000

송금인 자본거래 누적액(USD환산금액)
응답 메시지 형태
{
  "businessMessageIdentifier": "202412161004000000000",
  "userId": "01JR9JH2S5SG85EJDZK4XYXBV4",
  "accountId": "01JR9JHJSJQEREHWPCTB0XH2M5",
  "accumulatedAmountTotal": 21870,
  "accumulatedAmountCurrent": 10870,
  "accumulatedAmountCapital": 11000
}
에러인 경우 응답 메시지 명세
요청 메시지 명세
HTTP항목TYPE(길이)필수값설명
Bodymessage

string

N

요청에 실패했습니다.

오류 메시지
code

string("ERROR" | "BAD_REQUEST" | "INVALID_REQUEST" | "UNAUTHORIZED" | "FORBIDDEN" | "ACCESS_TOKEN_REQUIRED" | "ACCESS_TOKEN_EXPIRED" | "ACCESS_TOKEN_INVALID" | "ACCESS_TOKEN_NOT_ENOUGH_PERMISSION" | "AGENCY_NOT_FOUND" | "AGENCY_NOT_ACTIVE" | "AGENCY_NOT_APPROVED" | "AGENCY_NOT_MATCH" | "AGENCY_ACCESS_DENIED" | "AGENCY_CODE_DUPLICATED" | "MEMBER_NOT_FOUND" | "MEMBER_NOT_ACTIVE" | "MEMBER_NOT_MATCH" | "MEMBER_PASSWORD_NOT_MATCH" | "MEMBER_EMAIL_DUPLICATED" | "MEMBER_PASSWORD_RESET" | "MEMBER_PASSWO