收款方
查询创建收款方所需信息
端点目标 URL
沙盒环境请求地址：POST
https://api.futurepay-develop.com/api/v1/payee/beneficiaryRequiredDetails
生产环境请求地址：POST
https://api.futurepay.global/api/v1/payee/beneficiaryRequiredDetails
字段说明
调用的特定输入参数
| 字段名称 | 必填 | 类 型 | 描述 |
|---|---|---|---|
countryCode | M | string | 收款方所在国家/地区的国际标准化组织（ISO）两位国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
paymentChannelType | M | string | 支付方式（SWIFT、LOCAL、WALLET） |
currencyCode | M | string | 收款账户币种 |
accType | O | string | 账户类型(企业-company 个人-individual) |
调用的特定响应data参数
| 字段名 | 类型 | 说明 |
|---|---|---|
paymentChannelType | string | 支付方式 |
accType | string | 账户类型 |
countryCode | string | 收款方所在国家/地区 |
currencyCode | string | 收款账户币种 |
propertiesDetailMap | Object | 创建收款方所需信息动态字段项 |
propertiesDetailMap.XXX.required | string | 字段是否必填 |
propertiesDetailMap.XXX.type | string | 字段类型 |
propertiesDetailMap.XXX.regex | string | 字段对应正则表达式 |
propertiesDetailMap.XXX.enumContent | list | 字段对应枚举 |
propertiesDetailMap.XXX.maxLength | string | 字段最大长度 |
集成
查询创建收款方所需信息调用输入
{
"countryCode": "KR",
"paymentChannelType": "LOCAL",
"currencyCode": "KRW",
"accType": "individual",
}查询创建收款方所需信息调用输出
{
"code": "0",
"msg": "succeeded",
"serverTime": 1744006010499,
"data": [
{
"paymentChannelType": "LOCAL",
"accType": "individual",
"countryCode": "KR",
"currencyCode": "KRW",
"propertiesDetailMap": {
"residenceCountry": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "2"
},
"birthday": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "10"
},
"lastName": {
"required": "Y",
"type": "string",
"regex": "^[a-zA-Z0-9 .,()\\-\\s]+$",
"enumContent": [],
"maxLength": "128"
},
"zipCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "20"
},
"swiftCode": {
"required": "Y",
"type": "string",
"regex": "^(?:[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}(?:[A-Z0-9]{3})?)$",
"enumContent": [],
"maxLength": "11"
},
"bankName": {
"required": "Y",
"type": "string",
"regex": "^[a-zA-Z0-9\\s.,()]*$",
"enumContent": [],
"maxLength": "255"
},
"middleRoutingCode": {
"required": "N",
"type": "string",
"regex": "^\\d{9}$",
"enumContent": [],
"maxLength": "9"
},
"phoneNum": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "20"
},
"remark": {
"required": "N",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "255"
},
"middleSwiftCode": {
"required": "N",
"type": "string",
"regex": "^(?:[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}(?:[A-Z0-9]{3})?)$",
"enumContent": [],
"maxLength": "11"
},
"cardNo": {
"required": "Y",
"type": "string",
"regex": "^\\w{3,33}$",
"enumContent": [],
"maxLength": "33"
},
"mccCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [
{
"label": "3000-3350 Airlines and air transport companies",
"value": "3000-3350"
},
{
"label": "3351-3500 Car rental company",
"value": "3351-3500"
},
{
"label": "3501-3999 Accommodation - Hotels, motels, resorts",
"value": "3501-3999"
},
{
"label": "0742 Veterinary Services",
"value": "0742"
},
{
"label": "0763 Agricultural Cooperative",
"value": "0763"
},
{
"label": "0780 Landscaping Services",
"value": "0780"
},
{
"label": "1520 General Contractors",
"value": "1520"
},
{
"label": "1711 Heating, Plumbing, A/C",
"value": "1711"
},
{
"label": "1731 Electrical Contractors",
"value": "1731"
},
{
"label": "1740 Masonry, Stonework, and Plaster",
"value": "1740"
},
{
"label": "1750 Carpentry Contractors",
"value": "1750"
},
{
"label": "1761 Roofing/Siding, Sheet Metal",
"value": "1761"
},
{
"label": "1771 Concrete Work Contractors",
"value": "1771"
},
{
"label": "1799 Special Trade Contractors",
"value": "1799"
},
{
"label": "2741 Miscellaneous Publishing and Printing",
"value": "2741"
},
{
"label": "2791 Typesetting, Plate Making, and Related Services",
"value": "2791"
},
{
"label": "2842 Specialty Cleaning",
"value": "2842"
},
{
"label": "4011 Railroads",
"value": "4011"
},
{
"label": "4111 Commuter Transport, Ferries",
"value": "4111"
},
{
"label": "4112 Passenger Railways",
"value": "4112"
},
{
"label": "4119 Ambulance Services",
"value": "4119"
},
{
"label": "4121 Taxicabs/Limousines",
"value": "4121"
},
{
"label": "4131 Bus Lines",
"value": "4131"
},
{
"label": "4214 Motor Freight Carriers and Trucking - Local and Long Distance, Moving and Storage Companies, and Local Delivery Services",
"value": "4214"
},
{
"label": "4215 Courier Services",
"value": "4215"
},
{
"label": "4225 Public Warehousing and Storage – Farm Products, Refrigerated Goods, Household Goods, and Storage",
"value": "4225"
},
{
"label": "4411 Cruise Lines",
"value": "4411"
},
{
"label": "4457 Boat Rentals and Leases",
"value": "4457"
},
{
"label": "4468 Marinas, Service and Supplies",
"value": "4468"
},
{
"label": "4511 Airlines, Air Carriers",
"value": "4511"
},
{
"label": "4582 Airports, Flying Fields",
"value": "4582"
},
{
"label": "4722 Travel Agencies, Tour Operators",
"value": "4722"
},
{
"label": "4723 TUI Travel - Germany",
"value": "4723"
},
{
"label": "4784 Tolls/Bridge Fees",
"value": "4784"
},
{
"label": "4789 Transportation Services",
"value": "4789"
},
{
"label": "4812 Telecommunication Equipment and Telephone Sales",
"value": "4812"
},
{
"label": "4814 Telecommunication Services",
"value": "4814"
},
{
"label": "4816 Computer Network Services",
"value": "4816"
},
{
"label": "4821 Telegraph Services",
"value": "4821"
},
{
"label": "4829 Wires, Money Orders",
"value": "4829"
},
{
"label": "4899 Cable, Satellite, and Other Pay Television and Radio",
"value": "4899"
},
{
"label": "4900 Utilities",
"value": "4900"
},
{
"label": "5013 Motor Vehicle Supplies and New Parts",
"value": "5013"
},
{
"label": "5021 Office and Commercial Furniture",
"value": "5021"
},
{
"label": "5039 Construction Materials",
"value": "5039"
},
{
"label": "5044 Photographic, Photocopy, Microfilm Equipment, and Supplies",
"value": "5044"
},
{
"label": "5045 Computers, Peripherals, and Software",
"value": "5045"
},
{
"label": "5046 Commercial Equipment",
"value": "5046"
},
{
"label": "5047 Medical, Dental, Ophthalmic, and Hospital Equipment and Supplies",
"value": "5047"
},
{
"label": "5051 Metal Service Centers",
"value": "5051"
},
{
"label": "5065 Electrical Parts and Equipment",
"value": "5065"
},
{
"label": "5072 Hardware, Equipment, and Supplies",
"value": "5072"
},
{
"label": "5074 Plumbing, Heating Equipment, and Supplies",
"value": "5074"
},
{
"label": "5085 Industrial Supplies",
"value": "5085"
},
{
"label": "5094 Precious Stones and Metals, Watches and Jewelry",
"value": "5094"
},
{
"label": "5099 Durable Goods",
"value": "5099"
},
{
"label": "5111 Stationary, Office Supplies, Printing and Writing Paper",
"value": "5111"
},
{
"label": "5122 Drugs, Drug Proprietaries, and Druggist Sundries",
"value": "5122"
},
{
"label": "5131 Piece Goods, Notions, and Other Dry Goods",
"value": "5131"
},
{
"label": "5137 Uniforms, Commercial Clothing",
"value": "5137"
},
{
"label": "5139 Commercial Footwear",
"value": "5139"
},
{
"label": "5169 Chemicals and Allied Products",
"value": "5169"
},
{
"label": "5172 Petroleum and Petroleum Products",
"value": "5172"
},
{
"label": "5192 Books, Periodicals, and Newspapers",
"value": "5192"
},
{
"label": "5193 Florists Supplies, Nursery Stock, and Flowers",
"value": "5193"
},
{
"label": "5198 Paints, Varnishes, and Supplies",
"value": "5198"
},
{
"label": "5199 Nondurable Goods",
"value": "5199"
},
{
"label": "5200 Home Supply Warehouse Stores",
"value": "5200"
},
{
"label": "5211 Lumber, Building Materials Stores",
"value": "5211"
},
{
"label": "5231 Glass, Paint, and Wallpaper Stores",
"value": "5231"
},
{
"label": "5251 Hardware Stores",
"value": "5251"
},
{
"label": "5261 Nurseries, Lawn and Garden Supply Stores",
"value": "5261"
},
{
"label": "5271 Mobile Home Dealers",
"value": "5271"
},
{
"label": "5300 Wholesale Clubs",
"value": "5300"
},
{
"label": "5309 Duty Free Stores",
"value": "5309"
},
{
"label": "5310 Discount Stores",
"value": "5310"
},
{
"label": "5311 Department Stores",
"value": "5311"
},
{
"label": "5331 Variety Stores",
"value": "5331"
},
{
"label": "5399 Miscellaneous General Merchandise",
"value": "5399"
},
{
"label": "5411 Grocery Stores, Supermarkets",
"value": "5411"
},
{
"label": "5422 Freezer and Locker Meat Provisioners",
"value": "5422"
},
{
"label": "5441 Candy, Nut, and Confectionery Stores",
"value": "5441"
},
{
"label": "5451 Dairy Products Stores",
"value": "5451"
},
{
"label": "5462 Bakeries",
"value": "5462"
},
{
"label": "5499 Miscellaneous Food Stores – Convenience Stores and Specialty Markets",
"value": "5499"
},
{
"label": "5511 Car & Truck Dealers (New & Used) Sales, Service, Repairs Parts and Leasing",
"value": "5511"
},
{
"label": "5521 Car & Truck Dealers (Used Only) Sales, Service, Repairs Parts and Leasing",
"value": "5521"
},
{
"label": "5531 Auto and Home Supply Stores",
"value": "5531"
},
{
"label": "5532 Automotive Tire Stores",
"value": "5532"
},
{
"label": "5533 Automotive Parts and Accessories Stores",
"value": "5533"
},
{
"label": "5541 Service Stations",
"value": "5541"
},
{
"label": "5542 Automated Fuel Dispensers",
"value": "5542"
},
{
"label": "5551 Boat Dealers",
"value": "5551"
},
{
"label": "5561 Camper, Recreational and Utility Trailer Dealers",
"value": "5561"
},
{
"label": "5571 Motorcycle Shops and Dealers",
"value": "5571"
},
{
"label": "5592 Motor Homes Dealers",
"value": "5592"
},
{
"label": "5598 Snowmobile Dealers",
"value": "5598"
},
{
"label": "5599 Miscellaneous Auto Dealers",
"value": "5599"
},
{
"label": "5611 Men’s and Boy’s Clothing and Accessories Stores",
"value": "5611"
},
{
"label": "5621 Women’s Ready-To-Wear Stores",
"value": "5621"
},
{
"label": "5631 Women’s Accessory and Specialty Shops",
"value": "5631"
},
{
"label": "5641 Children’s and Infant’s Wear Stores",
"value": "5641"
},
{
"label": "5651 Family Clothing Stores",
"value": "5651"
},
{
"label": "5655 Sports and Riding Apparel Stores",
"value": "5655"
},
{
"label": "5661 Shoe Stores",
"value": "5661"
},
{
"label": "5681 Furriers and Fur Shops",
"value": "5681"
},
{
"label": "5691 Men’s, Women’s Clothing Stores",
"value": "5691"
},
{
"label": "5697 Tailors, Alterations",
"value": "5697"
},
{
"label": "5698 Wig and Toupee Stores",
"value": "5698"
},
{
"label": "5699 Miscellaneous Apparel and Accessory Shops",
"value": "5699"
},
{
"label": "5712 Furniture, Home Furnishings, and Equipment Stores, Except Appliances",
"value": "5712"
},
{
"label": "5713 Floor Covering Stores",
"value": "5713"
},
{
"label": "5714 Drapery, Window Covering, and Upholstery Stores",
"value": "5714"
},
{
"label": "5718 Fireplace, Fireplace Screens, and Accessories Stores",
"value": "5718"
},
{
"label": "5719 Miscellaneous Home Furnishing Specialty Stores",
"value": "5719"
},
{
"label": "5722 Household Appliance Stores",
"value": "5722"
},
{
"label": "5732 Electronics Stores",
"value": "5732"
},
{
"label": "5733 Music Stores-Musical Instruments, Pianos, and Sheet Music",
"value": "5733"
},
{
"label": "5734 Computer Software Stores",
"value": "5734"
},
{
"label": "5735 Record Stores",
"value": "5735"
},
{
"label": "5811 Caterers",
"value": "5811"
},
{
"label": "5812 Eating Places, Restaurants",
"value": "5812"
},
{
"label": "5813 Drinking Places",
"value": "5813"
},
{
"label": "5814 Fast Food Restaurants",
"value": "5814"
},
{
"label": "5912 Drug Stores and Pharmacies",
"value": "5912"
},
{
"label": "5921 Package Stores—Beer, Wine, and Liquor",
"value": "5921"
},
{
"label": "5931 Used Merchandise and Secondhand Stores",
"value": "5931"
},
{
"label": "5932 Antique Shops",
"value": "5932"
},
{
"label": "5933 Pawn Shops",
"value": "5933"
},
{
"label": "5935 Wrecking and Salvage Yards",
"value": "5935"
},
{
"label": "5937 Antique Reproductions",
"value": "5937"
},
{
"label": "5940 Bicycle Shops",
"value": "5940"
},
{
"label": "5941 Sporting Goods Stores",
"value": "5941"
},
{
"label": "5942 Book Stores",
"value": "5942"
},
{
"label": "5943 Stationery Stores, Office, and School Supply Stores",
"value": "5943"
},
{
"label": "5944 Jewelry Stores, Watches, Clocks, and Silverware Stores",
"value": "5944"
},
{
"label": "5945 Hobby, Toy, and Game Shops",
"value": "5945"
},
{
"label": "5946 Camera and Photographic Supply Stores",
"value": "5946"
},
{
"label": "5947 Gift, Card, Novelty, and Souvenir Shops",
"value": "5947"
},
{
"label": "5948 Luggage and Leather Goods Stores",
"value": "5948"
},
{
"label": "5949 Sewing, Needlework, Fabric, and Piece Goods Stores",
"value": "5949"
},
{
"label": "5950 Glassware, Crystal Stores",
"value": "5950"
},
{
"label": "5960 Direct Marketing - Insurance Services",
"value": "5960"
},
{
"label": "5962 Direct Marketing - Travel",
"value": "5962"
},
{
"label": "5963 Door-To-Door Sales",
"value": "5963"
},
{
"label": "5964 Direct Marketing - Catalog Merchant",
"value": "5964"
},
{
"label": "5965 Direct Marketing - Combination Catalog and Retail Merchant",
"value": "5965"
},
{
"label": "5966 Direct Marketing - Outbound Tele",
"value": "5966"
},
{
"label": "5967 Direct Marketing - Inbound Tele",
"value": "5967"
},
{
"label": "5968 Direct Marketing - Subscription",
"value": "5968"
},
{
"label": "5969 Direct Marketing - Other",
"value": "5969"
},
{
"label": "5970 Artist’s Supply and Craft Shops",
"value": "5970"
},
{
"label": "5971 Art Dealers and Galleries",
"value": "5971"
},
{
"label": "5972 Stamp and Coin Stores",
"value": "5972"
},
{
"label": "5973 Religious Goods Stores",
"value": "5973"
},
{
"label": "5996 Swimming Pools Sales",
"value": "5996"
},
{
"label": "5997 Electric Razor Stores",
"value": "5997"
},
{
"label": "5998 Tent and Awning Shops",
"value": "5998"
},
{
"label": "5999 Miscellaneous Specialty Retail",
"value": "5999"
},
{
"label": "6010 Manual Cash Disburse",
"value": "6010"
},
{
"label": "6011 Automated Cash Disburse",
"value": "6011"
},
{
"label": "6012 Financial Institutions",
"value": "6012"
},
{
"label": "6051 Non-Financial Institutions - Money Orders",
"value": "6051"
},
{
"label": "6211 Security Brokers/Dealers",
"value": "6211"
},
{
"label": "6300 Insurance Underwriting, Premiums",
"value": "6300"
},
{
"label": "6399 Insurance - Default",
"value": "6399"
},
{
"label": "6513 Real Estate Agents and Managers - Rentals",
"value": "6513"
},
{
"label": "7011 Hotels, Motels, and Resorts",
"value": "7011"
},
{
"label": "7012 Timeshares",
"value": "7012"
},
{
"label": "7032 Sporting/Recreation Camps",
"value": "7032"
},
{
"label": "7033 Trailer Parks, Campgrounds",
"value": "7033"
},
{
"label": "7276 Tax Preparation Services",
"value": "7276"
},
{
"label": "7277 Counseling Services",
"value": "7277"
},
{
"label": "7278 Buying/Shopping Services",
"value": "7278"
},
{
"label": "7296 Clothing Rental",
"value": "7296"
},
{
"label": "7297 Massage Parlors",
"value": "7297"
},
{
"label": "7298 Health and Beauty Spas",
"value": "7298"
},
{
"label": "7299 Miscellaneous General Services",
"value": "7299"
},
{
"label": "7210 Laundry, Cleaning Services",
"value": "7210"
},
{
"label": "7211 Laundries",
"value": "7211"
},
{
"label": "7216 Dry Cleaners",
"value": "7216"
},
{
"label": "7217 Carpet/Upholstery Cleaning",
"value": "7217"
},
{
"label": "7221 Photographic Studios",
"value": "7221"
},
{
"label": "7230 Barber and Beauty Shops",
"value": "7230"
},
{
"label": "7251 Shoe Repair/Hat Cleaning",
"value": "7251"
},
{
"label": "7261 Funeral Services, Crematories",
"value": "7261"
},
{
"label": "7273 Dating/Escort Services",
"value": "7273"
},
{
"label": "5975 Hearing Aids Sales and Supplies",
"value": "5975"
},
{
"label": "5976 Orthopedic Goods - Prosthetic Devices",
"value": "5976"
},
{
"label": "5977 Cosmetic Stores",
"value": "5977"
},
{
"label": "5978 Typewriter Stores",
"value": "5978"
},
{
"label": "5983 Fuel Dealers (Non Automotive)",
"value": "5983"
},
{
"label": "5992 Florists",
"value": "5992"
},
{
"label": "5993 Cigar Stores and Stands",
"value": "5993"
},
{
"label": "5994 News Dealers and Newsstands",
"value": "5994"
},
{
"label": "5995 Pet Shops, Pet Food, and Supplies",
"value": "5995"
},
{
"label": "7311 Advertising Services",
"value": "7311"
},
{
"label": "7321 Credit Reporting Agencies",
"value": "7321"
},
{
"label": "7333 Commercial Photography, Art and Graphics",
"value": "7333"
},
{
"label": "7338 Quick Copy, Repro, and Blueprint",
"value": "7338"
},
{
"label": "7339 Secretarial Support Services",
"value": "7339"
},
{
"label": "7342 Exterminating Services",
"value": "7342"
},
{
"label": "7349 Cleaning and Maintenance",
"value": "7349"
},
{
"label": "7361 Employment/Temp Agencies",
"value": "7361"
},
{
"label": "7372 Computer Programming",
"value": "7372"
},
{
"label": "7375 Information Retrieval Services",
"value": "7375"
},
{
"label": "7379 Computer Repair",
"value": "7379"
},
{
"label": "7392 Consulting, Public Relations",
"value": "7392"
},
{
"label": "7393 Detective Agencies",
"value": "7393"
},
{
"label": "7394 Equipment Rental",
"value": "7394"
},
{
"label": "7395 Photo Developing",
"value": "7395"
},
{
"label": "7399 Miscellaneous Business Services",
"value": "7399"
},
{
"label": "7511 Truck Stop",
"value": "7511"
},
{
"label": "7512 Car Rental Agencies",
"value": "7512"
},
{
"label": "7513 Truck/Utility Trailer Rentals",
"value": "7513"
},
{
"label": "7519 Recreational Vehicle Rentals",
"value": "7519"
},
{
"label": "7523 Parking Lots, Garages",
"value": "7523"
},
{
"label": "7531 Auto Body Repair Shops",
"value": "7531"
},
{
"label": "7534 Tire Retreading and Repair",
"value": "7534"
},
{
"label": "7535 Auto Paint Shops",
"value": "7535"
},
{
"label": "7538 Auto Service Shops",
"value": "7538"
},
{
"label": "7542 Car Washes",
"value": "7542"
},
{
"label": "7549 Towing Services",
"value": "7549"
},
{
"label": "7622 Electronics Repair Shops",
"value": "7622"
},
{
"label": "7623 A/C, Refrigeration Repair",
"value": "7623"
},
{
"label": "7629 Small Appliance Repair",
"value": "7629"
},
{
"label": "7631 Watch/Jewelry Repair",
"value": "7631"
},
{
"label": "7641 Furniture Repair, Refinishing",
"value": "7641"
},
{
"label": "7692 Welding Repair",
"value": "7692"
},
{
"label": "7699 Miscellaneous Repair Shops",
"value": "7699"
},
{
"label": "7829 Picture/Video Production",
"value": "7829"
},
{
"label": "7832 Motion Picture Theaters",
"value": "7832"
},
{
"label": "7841 Video Tape Rental Stores",
"value": "7841"
},
{
"label": "7911 Dance Hall, Studios, Schools",
"value": "7911"
},
{
"label": "7922 Theatrical Ticket Agencies",
"value": "7922"
},
{
"label": "7929 Bands, Orchestras",
"value": "7929"
},
{
"label": "7932 Billiard/Pool Establishments",
"value": "7932"
},
{
"label": "7933 Bowling Alleys",
"value": "7933"
},
{
"label": "7941 Sports Clubs/Fields",
"value": "7941"
},
{
"label": "7991 Tourist Attractions and Exhibits",
"value": "7991"
},
{
"label": "7992 Golf Courses - Public",
"value": "7992"
},
{
"label": "7993 Video Amusement Game Supplies",
"value": "7993"
},
{
"label": "7994 Video Game Arcades",
"value": "7994"
},
{
"label": "7995 Betting/Casino Gambling",
"value": "7995"
},
{
"label": "7996 Amusement Parks/Carnivals",
"value": "7996"
},
{
"label": "7997 Country Clubs",
"value": "7997"
},
{
"label": "7998 Aquariums",
"value": "7998"
},
{
"label": "7999 Miscellaneous Recreation Services",
"value": "7999"
},
{
"label": "8011 Doctors",
"value": "8011"
},
{
"label": "8021 Dentists, Orthodontists",
"value": "8021"
},
{
"label": "8031 Osteopaths",
"value": "8031"
},
{
"label": "8041 Chiropractors",
"value": "8041"
},
{
"label": "8042 Optometrists, Ophthalmologists",
"value": "8042"
},
{
"label": "8043 Opticians, Eyeglasses",
"value": "8043"
},
{
"label": "8049 Chiropodists, Podiatrists",
"value": "8049"
},
{
"label": "8050 Nursing/Personal Care",
"value": "8050"
},
{
"label": "8062 Hospitals",
"value": "8062"
},
{
"label": "8071 Medical and Dental Labs",
"value": "8071"
},
{
"label": "8099 Medical Services",
"value": "8099"
},
{
"label": "8111 Legal Services, Attorneys",
"value": "8111"
},
{
"label": "8211 Elementary, Secondary Schools",
"value": "8211"
},
{
"label": "8220 Colleges, Universities",
"value": "8220"
},
{
"label": "8241 Correspondence Schools",
"value": "8241"
},
{
"label": "8244 Business/Secretarial Schools",
"value": "8244"
},
{
"label": "8249 Vocational/Trade Schools",
"value": "8249"
},
{
"label": "8299 Educational Services",
"value": "8299"
},
{
"label": "8351 Child Care Services",
"value": "8351"
},
{
"label": "8398 Charitable and Social Service Organizations - Fundraising",
"value": "8398"
},
{
"label": "8641 Civic, Social, Fraternal Associations",
"value": "8641"
},
{
"label": "8651 Political Organizations",
"value": "8651"
},
{
"label": "8675 Automobile Associations",
"value": "8675"
},
{
"label": "8699 Membership Organizations",
"value": "8699"
},
{
"label": "8734 Testing Laboratories",
"value": "8734"
},
{
"label": "8911 Architectural/Surveying Services",
"value": "8911"
},
{
"label": "8931 Accounting/Bookkeeping Services",
"value": "8931"
},
{
"label": "8999 Professional Services",
"value": "8999"
},
{
"label": "9211 Court Costs, Including Alimony and Child Support - Courts of Law",
"value": "9211"
},
{
"label": "9222 Fines - Government Administrative Entities",
"value": "9222"
},
{
"label": "9223 Bail and Bond Payments",
"value": "9223"
},
{
"label": "9311 Tax Payments - Government Agencies",
"value": "9311"
},
{
"label": "9399 Government Services",
"value": "9399"
},
{
"label": "9402 Postal Services - Government Only",
"value": "9402"
},
{
"label": "9405 U.S. Federal Government Agencies or Departments",
"value": "9405"
},
{
"label": "9950 Intra-Company Purchases",
"value": "9950"
}
],
"maxLength": "4"
},
"addressDetail": {
"required": "Y",
"type": "string",
"regex": "^[a-zA-Z0-9\\s.\\-\\,()]*$",
"enumContent": [],
"maxLength": ""
},
"passport": {
"required": "N",
"type": "string",
"regex": "^[A-Z0-9]{8,9}$",
"enumContent": [],
"maxLength": "9"
},
"countryCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [
{
"label": "KR",
"value": "KR"
}
],
"maxLength": "2"
},
"phoneCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "10"
},
"bsbCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "6"
},
"accType": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [
{
"label": "individual",
"value": "individual"
}
],
"maxLength": "10"
},
"merchantReference": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "32"
},
"ifscCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "11"
},
"email": {
"required": "Y",
"type": "string",
"regex": "^\\w+([- .]\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$",
"enumContent": [],
"maxLength": "100"
},
"bankCode": {
"required": "Y",
"type": "string",
"regex": "^\\d{3}$",
"enumContent": [],
"maxLength": "12"
},
"cardType": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [
{
"label": "Savings Account",
"value": "Savings Account"
},
{
"label": "Current Account",
"value": "Current Account"
},
{
"label": "Maestra Account",
"value": "Maestra Account"
},
{
"label": "Checking Account",
"value": "Checking Account"
}
],
"maxLength": "20"
},
"driverLicence": {
"required": "N",
"type": "string",
"regex": "^[A-Z0-9]{6,15}$",
"enumContent": [],
"maxLength": "15"
},
"paymentChannelType": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [
{
"label": "LOCAL",
"value": "LOCAL"
}
],
"maxLength": "6"
},
"sortCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "6"
},
"branchCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "64"
},
"accountCcy": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [
{
"label": "KRW",
"value": "KRW"
}
],
"maxLength": "3"
},
"firstName": {
"required": "Y",
"type": "string",
"regex": "^[a-zA-Z0-9 .,()\\-\\s]+$",
"enumContent": [],
"maxLength": "128"
},
"phoneCountryCode": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "2"
},
"middleBankName": {
"required": "N",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "128"
},
"residenceCity": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "64"
},
"routingCode": {
"required": "Y",
"type": "string",
"regex": "^\\d{9}$",
"enumContent": [],
"maxLength": "9"
},
"residenceProvince": {
"required": "Y",
"type": "string",
"regex": "",
"enumContent": [],
"maxLength": "64"
},
"businessDescribe": {
"required": "Y",
"type": "string",
"regex": "^[a-zA-Z0-9\\s.\\-\\,()]*$",
"enumContent": [],
"maxLength": "255"
},
"payeeUrl": {
"required": "N",
"type": "string",
"regex": "^(https?:\/\/)?([a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}(\/[^\\s]*)?$",
"enumContent": [],
"maxLength": "255"
}
}
}
],
"success": true
}创建收款方
端点目标 URL
沙盒环境请求地址：POST https://api.futurepay-develop.com/api/v1/payee/create
生产环境请求地址：POST https://api.futurepay.global/api/v1/payee/create
字段说明
调用的特定输入参数
| 字段名称 | 必填 | 类 型 | 描述 |
|---|---|---|---|
merchantReference | M | string | 商户请求流水号，不能重复 |
countryCode | M | string | 收款方银行所在国家/地区的国际标准化组织（ISO）两位国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准） |
accountCcy | M | string | 收款账户币种 |
paymentChannelType | M | string | 支付方式（SWIFT、LOCAL、WALLET） |
accType | M | string | 账户类型(企业-company 个人-individual) |
cardNo | M | string | 收款方账号 |
accountName | O | string | 收款方账号名称，如果账户类型为企业，该值必填 |
firstName | O | string | 收款方名字，如果账户类型为个人，该值必填 |
lastName | O | string | 收款方姓式，如果账户类型为个人，该值必填 |
cardType | O | string | Savings Account-活期账户,Current Account-储蓄账户,Maestra Account-Maestra账户,Checking Account-支票账户 |
walletType | O | string | 钱包类型 |
swiftCode | O | string | swiftCode银行信息代码(查询银行信息 参考) |
bankName | O | string | 收款行名称(查询银行信息 参考) |
routingCode | O | string | 收款行路由编号(查询银行信息 参考) |
sortCode | O | string | (查询银行信息 参考) |
bsbCode | O | string | (查询银行信息 参考) |
ifscCode | O | string | (查询银行信息 参考) |
bankCode | O | string | (查询银行信息 参考) |
branchCode | O | string | (查询银行信息 参考) |
middleSwiftCode | O | string | 中间行swiftCode银行信息代码(查询银行信息 参考) |
middleBankName | O | string | 中间行银行名称(查询银行信息 参考) |
middleRoutingCode | O | string | 中间行路由编号(查询银行信息 参考) |
residenceCountry | O | string | 收款方居住国家/地区 |
residenceProvince | O | string | 收款方居住省/州 |
residenceCity | O | string | 收款方居住城市 |
addressDetail | O | string | 收款方居住详细地址 |
zipCode | O | string | 收款方居住所在地编码 |
phoneCountryCode | O | string | 收款方手机号所在国家 |
phoneCode | O | string | 收款方手机号区号 |
phoneNum | O | string | 收款方手机号 |
email | O | string | 收款方邮箱 |
birthday | O | string | 收款方出生日期 |
driverLicence | O | string | 收款方驾照 |
mccCode | O | string | mcc代码 |
businessDescribe | O | string | 收款业务描述 |
payeeUrl | O | string | 收款方网址 |
remark | O | string | 备注 |
调用的特定响应data参数
| 字段名 | 类型 | 说明 |
|---|---|---|
merchantReference | String | 商户请求流水号 |
payeeId | String | 收款方Id |
resultCode | String | 收款方状态，ACCEPT(通过) REJECT(禁止) REVIEW(等待中) |
集成
创建收款方调用输入
{
"merchantReference":"xpoiasdiuqwenj23890",
"countryCode":"US",
"accountCcy":"USD",
"paymentChannelType":"SWIFT",
"accType":"company",
"accountName":"000 simple sentence.",
"cardNo":"987654221",
"swiftCode":"MRBAEGCX018",
"addressDetail":"Macy Alameda Spring and Arcadia streets",
"middleSwiftCode":"MRBAEGCX018",
"routingCode":"987654321"
}创建收款方调用输出
{
"code": "0",
"msg": "success",
"serverTime": 1738831561912,
"data": {
"merchantReference": "xpoiasdiuqwenj23890",
"payeeId": "632",
"resultCode": "REVIEW"
},
"success": true
}查询收款方
端点目标 URL
字段说明
调用的特定输入参数
| 字段名称 | 必填 | 类 型 | 描述 |
|---|---|---|---|
merchantReference | M | string | 创建收款方时商户提交的流水号 |
调用的特定响应data参数
| 字段名 | 类型 | 说明 |
|---|---|---|
merchantReference | String | 商户请求流水号 |
payeeId | String | 收款方Id |
resultCode | String | 收款方状态，ACCEPT(通过) REJECT(禁止) REVIEW(等待中) |
集成
查询收款方调用输入
{
"merchantReference":"xpoiasdiuqwenj23890"
}查询收款方调用输出
{
"code": "0",
"msg": "success",
"serverTime": 1738831610618,
"data": {
"merchantReference": "xpoiasdiuqwenj23890",
"payeeId": "632",
"resultCode": "ACCEPT"
},
"success": true
}WEBHOOK
{
"appId":"1864861460728012800",
"merchantId":"1864861460719644672",
"notificationItems":[
{
"eventCode":"CREATE_RECEIVER_RESULT",
"eventDate":1738831562027,
"merchantReference":"81092123hkjhaew124",
"payeeId":632,
"resultCode":"ACCEPT"
}
]
}Updated 4 days ago