1. 接入指南
珊瑚跨境开放平台
  • 欢迎接入珊瑚开放平台
  • 接入指南
    • 开放平台介绍
    • API 接入申请
    • 服务器白名单
    • 数字证书使用
    • 错误与异常码
    • SDK 生成引导
    • 更新日志
    • 关联账户概念
  • 进件
    • 进件说明
    • 提交进件(快照)
      POST
    • 进件列表查询
      GET
    • 进件明细查询
      GET
    • 进件状态查询
      GET
    • 进件明细更新
      PUT
  • 存款
    • 全球收款账户
      • 全球收款账户申请
      • 全球收款账户列表
      • 全球收款账户详情
    • 入账查询
      • 入账列表
      • 入账详情
    • 入账关联订单
      • 订单上传〔批量〕
      • 订单结果查询
      • 订单可用金额查询
  • 付款
    • 受益人管理
      • 受益人申请
      • 受益人删除
      • 受益人列表
      • 受益人明细
      • 受益人校验
    • 付款
      • 转账链接
      • 交易提交
      • 交易撤销
      • 交易列表
      • 交易详情
  • 发行
    • 珊瑚卡
      • 功能开通
      • 珊瑚卡申请
      • 珊瑚卡编辑
      • 珊瑚卡列表
      • 珊瑚卡详情〔敏感〕
      • 珊瑚卡详情
      • 珊瑚卡余额
      • 珊瑚卡余量
      • 珊瑚卡更新
    • 授权
      • 授权记录列表
    • VCC钱包
      • 查询 VCC 钱包余额
      • 查询 VCC 钱包余额流水
      • 转账交易
      • 交易查询
      • 交易列表
    • 清算
      • 清算记录列表
  • 店铺
    • 关联店铺
    • 解除关联店铺
  • 辅助工具
    • 模拟
      • 审核模拟
      • 事件模拟
    • 上传相关文件
    • 下载相关文件
  • 多币种钱包
    • 查询电子钱包余额
    • 查询钱包账户余额流水
  • 换汇
    • 查询当前汇率
  • 事件订阅
    • 接入说明
    • 事件说明
    • 钱包存款事件
  • 附录
    • 进件字段说明
    • 复杂枚举说明
    • 账户申请说明
  • 数据模型
    • 事件模型
      • 字段说明 - 进件通知
      • 字段说明 - 受益人风险通知
      • 字段说明 - 申请通知(全球收款账户)
      • 字段说明 - 付款通知
      • 字段说明 - 订单通知(上传 | 解析)
      • 字段说明 - 订单通知(汇总)
      • 字段说明 - 额度变更通知
      • 字段说明 - 申请通知(珊瑚卡)
      • 字段说明 - 授权通知(珊瑚卡)
      • 字段说明 - 收款通知
      • 字段说明 - 入账通知
    • OrderBatchUploadErrorDTO
    • GlobalApplyVO
    • VCCPayoutApplyPayerVO
    • VCCBalanceListVO
    • CurrentRateDTO
    • ConnectedVO
    • CardSensitivityVO
    • CardBalanceVO
    • IncomeListDTO
    • CardCleaningListPayerVO
    • CardApplyVO
    • TransactionDetailDTO
    • DepositListPayerVO
    • Card3DetailRangeVO
    • VCCRecordListPayerVO
    • CardFunctionVO
    • AccountBalanceDTO
    • Result?
    • CardStatusVO
    • KycApplyVO
    • GlobalListVO
    • GlobalDetailVO
    • VCCPayoutDetailPayerVO
    • OrderAmountVO
    • PayoutApplyVO
    • PayoutDetailPayerVO
    • BeneficiaryDeleteVO
    • PayoutListPayerVO
    • OperationAuditVO
    • CardDeregisterVO
    • VCCPayoutListPayerVO
    • EventReceiptVO
    • CardRestrictVO
    • OrderStatusVO
    • CardAuthorizationListPayerVO
    • CardAuthorizationListPayeeVO
    • ResultGlobalApplyVO
    • VCCPayoutApplyPayeeVO
    • Result«CurrentRateDTO»
    • ResultConnectedVO
    • ResultCardSensitivityVO
    • PageResultListAccountInfoDTO
    • ResultCardBalanceVO
    • PageResultListIncomeListDTO
    • CardCleaningListPayeeVO
    • ResultListVCCBalanceVO
    • ResultCardApplyVO
    • UplodOrderResultDTO
    • PageResultListTransactionDetailDTO
    • DepositListPayeeVO
    • DepositDetailPayerVO
    • PageableVCCBalanceListVO
    • VCCRecordListPayeeVO
    • ResultCardFunctionVO
    • ResultListAccountBalanceDTO
    • ResultCardStatusVO
    • ResultKycApplyVO
    • PageableGlobalListVO
    • ResultGlobalDetailVO
    • Payer
    • VCCPayoutDetailPayeeVO
    • ResultListOrderAmountVO
    • ResultPayoutApplyVO
    • PayoutDetailPayeeVO
    • ResultBeneficiaryDeleteVO
    • PayoutListPayeeVO
    • ResultOperationAuditVO
    • ResultCardDeregisterVO
    • VCCPayoutListPayeeVO
    • ResultEventReceiptVO
    • ResultCardRestrictVO
    • ResultOrderStatusVO
    • CurrentRateQueryDTO
    • GlobalApplyDTO
    • VCCPayoutApplyVO
    • ConnectedDTO
    • CardApplyDTO
    • Result«UplodOrderResultDTO»
    • DepositDetailPayeeVO
    • ResultPageableVCCBalanceListVO
    • VCCRecordListVO
    • CardFunctionDTO
    • AccountOpenInfo
    • CardStatusDTO
    • KycApplyUserDTO
    • ResultPageableGlobalListVO
    • Payee
    • DepositListVO
    • VCCPayoutDetailVO
    • PayoutListVO
    • PayoutDetailVO
    • PayoutApplyDTO
    • OperationAuditDTO
    • TransactionDetailListQueryDTO
    • CardDeregisterDTO
    • IncomeListQueryDTO
    • VCCPayoutListVO
    • key
    • ResultVCCPayoutApplyVO
    • DisconnectVO
    • CardModifyVO
    • OrderDetail
    • PageablePayoutListVO
    • PageableVCCRecordListVO
    • MerchantInfo
    • KycApplyEnterpriseBeneficiaryDTO
    • DepositDetailVO
    • PageableDepositListVO
    • ResultVCCPayoutDetailVO
    • ResultPayoutDetailVO
    • PageableVCCPayoutListVO
    • MapObject
    • VCCPayoutApplyDTO
    • ResultDisconnectVO
    • ResultCardModifyVO
    • ResultPageableVCCRecordListVO
    • AccountInfoDTO
    • KycApplyEnterpriseLegalDTO
    • ResultDepositDetailVO
    • ResultPageableDepositListVO
    • ResultPageablePayoutListVO
    • OrderBatchUploadDTO
    • ResultPageableVCCPayoutListVO
    • EventReceiptDTO
    • DisconnectDTO
    • CardModifyDTO
    • ResultAccountInfoDTO
    • KycApplyEnterpriseDirectorDTO
    • AccountInfoQueryDTO
    • CardListVO
    • KycApplyEnterpriseAgentDTO
    • PageableCardListVO
    • KycApplyEnterpriseDTO
    • ResultPageableCardListVO
    • KycApplyIndividualDTO
    • CardDetailVO
    • KycApplyDetailDTO
    • ResultCardDetailVO
    • KycApplyDTO
    • KycListUserDTO
    • KycDetailUserDTO
    • KycListEnterpriseBeneficiaryDTO
    • KycDetailEnterpriseBeneficiaryDTO
    • PayoutCancelVO
    • KycListEnterpriseLegalDTO
    • CardRemainVO
    • KycDetailEnterpriseLegalDTO
    • ResultPayoutCancelVO
    • KycListEnterpriseDirectorDTO
    • ResultCardRemainVO
    • KycDetailEnterpriseDirectorDTO
    • PayoutCancelDTO
    • PayoutLinkVO
    • KycListEnterpriseAgentDTO
    • CardActiveVO
    • KycDetailEnterpriseAgentDTO
    • PayoutLinkApplyVO
    • Card3DetailRangeVO
    • BeneficiaryApplyVO
    • ResultPayoutLinkVO
    • KycListEnterpriseDTO
    • ResultCardActiveVO
    • KycDetailEnterpriseDTO
    • ResultPayoutLinkApplyVO
    • ResultBeneficiaryApplyVO
    • KycListIndividualDTO
    • CardActiveDTO
    • KycDetailIndividualDTO
    • PayoutLinkApplyDTO
    • BeneficiaryApplyDTO
    • OrderUploadVO
    • KycListDetailDTO
    • CardFrozeVO
    • KycDetailDetailDTO
    • ResultOrderUploadVO
    • KycListVO
    • ResultCardFrozeVO
    • KycDetailVO
    • OrderUploadDTO
    • PageableKycListVO
    • CardFrozeDTO
    • PageableKycDetailVO
    • BeneficiaryListVO
    • ResultPageableKycListVO
    • CardAuthorizationListVO
    • ResultPageableKycDetailVO
    • ResultListBeneficiaryListVO
    • PageableCardAuthorizationListVO
    • ResultKycDetailVO
    • BeneficiaryDetailVO
    • ResultPageableCardAuthorizationListVO
    • KycQueryVO
    • ResultBeneficiaryDetailVO
    • CardCleaningListVO
    • ResultKycQueryVO
    • PageableCardCleaningListVO
    • KycModifyVO
    • ResultPageableCardCleaningListVO
    • ResultKycModifyVO
    • KycModifyUserDTO
    • CardParticularListVO
    • KycModifyEnterpriseBeneficiaryDTO
    • PageableCardParticularListVO
    • KycModifyEnterpriseLegalDTO
    • ResultPageableCardParticularListVO
    • KycModifyEnterpriseDirectorDTO
    • VCCBalanceVO
    • KycModifyEnterpriseAgentDTO
    • ResultVCCBalanceVO
    • KycModifyEnterpriseDTO
    • KycModifyIndividualDTO
    • KycModifyDetailDTO
    • KycModifyDTO
    • VCCRechargeListVO
    • PageableVCCRechargeListVO
    • ResultPageableVCCRechargeListVO
    • VCCWithdrawListVO
    • PageableVCCWithdrawListVO
    • ResultPageableVCCWithdrawListVO
    • WalletBalanceVO
    • ResultListWalletBalanceVO
    • WalletHistoryVO
    • PageableWalletHistoryVO
    • ResultPageableWalletHistoryVO
  1. 接入指南

服务器白名单

💡
为了保障接口安全,接入 OpenAPI 时需要对服务器的固定出口 IP 进行白名单配置。以下是具体的接入步骤说明:
1
确定服务器的固定出口 IP
请确认集成方服务器是否有固定的出口 IP 地址(支持多个 IP)。这将用于配置在白名单中以确保仅授权的服务器能够访问接口。
💡
注意:
如果使用负载均衡器或代理服务器,请确保出口流量的 IP 地址稳定且可追踪。
如无法提供固定 IP,建议使用 VPN 或其他网络解决方案以实现固定出口。
2
提供固定出口 IP 信息
收集集成方的固定出口 IP 地址,并按照以下格式提供:
公司名称:XXX
出口 IP 列表:
1. xxx.xxx.xxx.xxx
2. xxx.xxx.xxx.xxx
联系人姓名:XXX
联系电话:XXX
3
发送固定出口 IP 信息
将以上信息通过邮件发送至指定的邮箱:
📌
邮箱地址:openapi@coralglobal.cn
邮件主题:【OpenAPI 集成】固定出口 IP 提交
示例邮件格式:
尊敬的珊瑚开发团队:

我们正在集成贵公司的 OpenAPI 接口,现提交固定出口 IP 信息如下:

公司名称:XXX 公司
出口 IP 列表:
1. 123.123.123.123
2. 124.124.124.124

联系人姓名:张三
联系电话:138-0000-0000

感谢支持!

此致
敬礼
XXX 公司
4
运维团队配置白名单
收到出口 IP 信息后,运维团队将在系统中完成白名单配置。预计处理时间为 1-2 个工作日。
📌
若固定出口 IP 发生变更,请按照上述步骤重新提交更新的出口 IP 信息,以确保接口访问不受影响。
如在配置过程中有任何问题,请联系:
技术支持邮箱:openapi@coralglobal.cn
修改于 2025-01-21 05:13:59
上一页
API 接入申请
下一页
数字证书使用
Built with