LianLian Global Gateway API

swagger: '2.0'
info:
  title: Distribution Account Gateway API
  version: '1.0'
host: global-api-sandbox.lianlianpay-inc.com
basePath: /b2b-import/v1
schemes:
- https
consumes:
- application/json
produces:
- application/json
tags:
- name: Gateway
paths:
  /gateway/vcc-api/account:
    parameters: []
    get:
      summary: 查询账户余额
      tags:
      - Gateway
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    code: 100001
                    data:
                      merchantId: vcc_merchant_001
                      accountList:
                      - amount: '1082.00'
                        currency: USD
                        frozenAmount: '0.00'
                      userId: '2023012966287896'
                    success: true
                    message: SUCCESS
                properties:
                  code:
                    type: integer
                    description: 响应码
                  data:
                    type: object
                    properties:
                      merchantId:
                        type: string
                      accountList:
                        type: array
                        description: 账单币种账户列表
                        items:
                          type: object
                          properties:
                            amount:
                              type: string
                              description: 可用金额
                            currency:
                              type: string
                              description: 账单币种，参考ISO currency code
                            frozenAmount:
                              type: string
                              description: 待出账金额：已发生授权但尚未出账的金额
                      userId:
                        type: string
                        description: VCC用户号
                  success:
                    type: boolean
                    description: 成功标识
                  message:
                    type: string
                    description: 响应描述
              examples:
                Example 1:
                  value:
                    code: 100001
                    data:
                      accountList:
                      - amount: '99800.00'
                        currency: GBP
                        frozenAmount: '4414.52'
                      - amount: '0.00'
                        currency: SGD
                        frozenAmount: '0.00'
                      - amount: '999980.00'
                        currency: EUR
                        frozenAmount: '20.00'
                      userId: '2023020766827854'
                    success: true
                    message: SUCCESS
        '404':
          description: User Not Found
      operationId: get-vcc-account-balance
      description: "Sandbox : https://test-global-api.lianlianpay-inc.com\r\n\r\nProd    : https://global-api.lianlian.com\r\n\r\n账户余额指的是单用户的各币种余额情况，包含以下几种类型：\r\n- Pending：授权但尚未被结算的交易总金额，余额处于冻结状态\r\n- Available：实际可用金额\r\n"
      x-stoplight:
        id: ixww4yiwjv4m4
      parameters:
      - schema:
          type: string
        in: header
        name: 'Authorization:'
        description: Basic {token}
      - schema:
          type: string
        in: header
        name: 'LLPAY-Signature:'
        description: t={REQUEST_EPOCH},v={payload}
  /gateway/vcc-api/account/flow:
    parameters: []
    post:
      summary: 查询资金明细
      tags:
      - Gateway
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    code: 100001
                    data:
                      total: 3
                      list:
                      - amount: '10.00'
                        cardName: '305879222977541'
                        accountType: VCC_ACCOUNT
                        debitOrCredit: DEBIT
                        transactionId: '2025012092930317'
                        serialNo: '20250120190501978130'
                        remainAcctBalance: '9980.00'
                        transactionType: SETTLE
                        acctDateTime: '2025-01-20 19:05:01'
                        last4digits: '4047'
                        acctNo: '20241107000012'
                        cardId: '2025012092871304'
                        currency: USD
                      - amount: '10.00'
                        cardName: '305879222977541'
                        accountType: VCC_ACCOUNT
                        debitOrCredit: DEBIT
                        transactionId: '2025012092930398'
                        serialNo: '20250120190501768303'
                        remainAcctBalance: '9990.00'
                        transactionType: SETTLE
                        acctDateTime: '2025-01-20 19:05:01'
                        last4digits: '4047'
                        acctNo: '20241107000012'
                        cardId: '2025012092871304'
                        currency: USD
                      - amount: '10.50'
                        cardName: '282924061885445'
                        accountType: VCC_ACCOUNT
                        debitOrCredit: DEBIT
                        transactionId: '2025011686664964'
                        serialNo: '20250116193005846236'
                        remainAcctBalance: '-0.50'
                        transactionType: 3DS_OTP_FEE
                        acctDateTime: '2025-01-16 19:30:05'
                        last4digits: '8902'
                        acctNo: '20241107000012'
                        cardId: '2025011686540614'
                        currency: USD
                    success: true
                    message: SUCCESS
                properties:
                  code:
                    type: integer
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                      list:
                        type: array
                        items:
                          type: object
                          properties:
                            amount:
                              type: string
                              description: 金额，单位：元
                            cardName:
                              type: string
                              description: 卡片名称
                            accountType:
                              type: string
                              description: 资金账户类型
                            debitOrCredit:
                              type: string
                              description: 金额正负号（CREDIT为正，DEBIT为负）
                            transactionId:
                              type: string
                              description: 关联交易单号
                            serialNo:
                              type: string
                              description: 资金流水号
                            remainAcctBalance:
                              type: string
                              description: 变动后总额度，单位：元
                            transactionType:
                              type: string
                              description: 交易类型（见入参枚举类型）
                            acctDateTime:
                              type: string
                              description: 动账时间，格式yyyy-MM-dd HH:mm:ss
                            last4digits:
                              type: string
                              description: 卡片尾号
                            acctNo:
                              type: string
                              description: 余额账户号
                            cardId:
                              type: string
                              description: 卡片唯一识别号
                            currency:
                              type: string
                              description: 币种，参考ISO currency code
                            subAccountName:
                              type: string
                              x-stoplight:
                                id: 5xpnfd40abq63
                              description: 子资金账户名称
                            subAccountId:
                              type: string
                              x-stoplight:
                                id: syukr18tdunec
                              description: 子资金账户id
                  success:
                    type: boolean
                  message:
                    type: string
              examples:
                Example 1:
                  value:
                    code: 100001
                    data:
                      total: 3
                      list:
                      - amount: '10.00'
                        cardName: '305879222977541'
                        accountType: VCC_ACCOUNT
                        debitOrCredit: DEBIT
                        transactionId: '2025012092930317'
                        serialNo: '20250120190501978130'
                        remainAcctBalance: '9980.00'
                        transactionType: SETTLE
                        acctDateTime: '2025-01-20 19:05:01'
                        last4digits: '4047'
                        acctNo: '20241107000012'
                        cardId: '2025012092871304'
                        currency: USD
                      - amount: '10.00'
                        cardName: '305879222977541'
                        accountType: VCC_ACCOUNT
                        debitOrCredit: DEBIT
                        transactionId: '2025012092930398'
                        serialNo: '20250120190501768303'
                        remainAcctBalance: '9990.00'
                        transactionType: SETTLE
                        acctDateTime: '2025-01-20 19:05:01'
                        last4digits: '4047'
                        acctNo: '20241107000012'
                        cardId: '2025012092871304'
                        currency: USD
                      - amount: '10.50'
                        cardName: '282924061885445'
                        accountType: VCC_ACCOUNT
                        debitOrCredit: DEBIT
                        transactionId: '2025011686664964'
                        serialNo: '20250116193005846236'
                        remainAcctBalance: '-0.50'
                        transactionType: 3DS_OTP_FEE
                        acctDateTime: '2025-01-16 19:30:05'
                        last4digits: '8902'
                        acctNo: '20241107000012'
                        cardId: '2025011686540614'
                        currency: USD
                    success: true
                    message: SUCCESS
        '404':
          description: User Not Found
      operationId: post-gateway-vcc-api-account-flow
      x-stoplight:
        id: yjt8dyc0ezcpj
      description: "Sandbox : https://test-global-api.lianlianpay-inc.com\r\n\r\nProd    : https://global-api.lianlian.com"
      parameters:
      - schema:
          type: string
        in: header
        name: 'Authorization:'
        description: Basic {token}
      - schema:
          type: string
        in: header
        name: 'LLPAY-Signature:'
        description: t={REQUEST_EPOCH},v={payload}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-examples:
                Example 1:
                  pageNo: 1
                  pageSize: 10
                  acctDateTimeStart: '2025-01-01'
                  acctDateTimeEnd: '2025-02-27'
              required:
              - pageNo
              - pageSize
              - acctDateTimeStart
              - acctDateTimeEnd
              properties:
                vccUserId:
                  type: string
                  x-stoplight:
                    id: nqqzs3mksdpbk
                  description: "用户ID(联系项目经理获取)\r\n\r\n商户模式必传"
                pageNo:
                  type: integer
                  description: "页码\r\n\r\n不传默认1"
                pageSize:
                  type: integer
                  description: "分页大小\r\n\r\n至多200, 不传默认10"
                acctDateTimeStart:
                  type: string
                  description: 账期起始时间yyyy-MM-dd
                acctDateTimeEnd:
                  type: string
                  description: 账期结束时间yyyy-MM-dd
                serialNo:
                  type: string
                  x-stoplight:
                    id: x0k8sg16lszzj
                  description: 资金流水号
                currency:
                  type: string
                  x-stoplight:
                    id: ng0m4tulsyie1
                  description: 币种
                cardId:
                  type: string
                  x-stoplight:
                    id: 1zbnj4xm8kh7d
                  description: 卡唯一识别号
                transactionId:
                  type: string
                  x-stoplight:
                    id: ao5bxqbczi4m1
                  description: 关联交易单号
                transactionType:
                  $ref: '#/components/schemas/transactionType'
                  x-stoplight:
                    id: lz0w6hqep5aq1
                accountType:
                  $ref: '#/components/schemas/accountType'
                  x-stoplight:
                    id: nr3mp7dsej663
                subAccountName:
                  type: string
                  x-stoplight:
                    id: 6tpxazi2uvk5e
                  description: 子账户名称, 精确匹配
                subAccountId:
                  type: string
                  x-stoplight:
                    id: jrc889xgv9lhr
                  description: 子账户唯一识别号
            examples:
              Example 1:
                value:
                  pageNo: 1
                  pageSize: 10
                  acctDateTimeStart: '2025-01-01'
                  acctDateTimeEnd: '2025-02-27'
  /gateway/vcc-api/subaccount/add:
    post:
      summary: 新建子账户
      tags:
      - Gateway
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    value:
                      code: 100001
                      data:
                        subAccountName: zwytest_subaccount_1
                        subAccountId: '2025111833865777'
                        status: VALID
                      success: true
                      message: SUCCESS
                properties:
                  value:
                    type: object
                    properties:
                      code:
                        type: integer
                      data:
                        type: object
                        properties:
                          subAccountName:
                            type: string
                            description: 子资金账户名称
                          subAccountId:
                            type: string
                            description: 子资金账户id
                          status:
                            type: string
                            description: "子账户状态\r\n- VALID 有效\r\n- CANCEL 注销"
                      success:
                        type: boolean
                      message:
                        type: string
              examples:
                Example 1:
                  value:
                    code: 100001
                    data:
                      subAccountName: test
                      subAccountId: '2025111833865777'
                      status: VALID
                    success: true
                    message: SUCCESS
      operationId: post-gateway-vcc-api-subaccount-add
      x-stoplight:
        id: xn4luyi6ur9bf
      description: "Sandbox : https://test-global-api.lianlianpay-inc.com\r\n\r\nProd    : https://global-api.lianlian.com\r\n\r\n如需开通子用户模式，请联系客户经理申请配置"
      parameters:
      - schema:
          type: string
        in: header
        name: 'Authorization:'
        description: Basic {token}
      - schema:
          type: string
        in: header
        name: 'LLPAY-Signature:'
        description: t={REQUEST_EPOCH},v={payload}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-examples:
                Example 1:
                  subAccountName: zwytest_subaccount_1
              required:
              - subAccountName
              properties:
                subAccountName:
                  type: string
                  description: 子账户名称</br>幂等返回
            examples:
              Example 1:
                value:
                  subAccountName: test
  /gateway/vcc-api/subaccount/update:
    post:
      summary: 编辑子账户
      tags:
      - Gateway
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    code: 100001
                    data: true
                    success: true
                    message: SUCCESS
                properties:
                  code:
                    type: integer
                  success:
                    type: boolean
                  message:
                    type: string
              examples:
                Example 1:
                  value:
                    code: 100001
                    success: true
                    message: SUCCESS
      operationId: post-gateway-vcc-api-subaccount-update
      x-stoplight:
        id: bzpac7qxepxk3
      description: "Sandbox : https://test-global-api.lianlianpay-inc.com\r\n\r\nProd    : https://global-api.lianlian.com"
      parameters:
      - schema:
          type: string
        in: header
        name: 'Authorization:'
        description: Basic {token}
      - schema:
          type: string
        in: header
        name: 'LLPAY-Signature:'
        description: t={REQUEST_EPOCH},v={payload}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-examples:
                Example 1:
                  subAccountId: '2025111833785290'
                  subAccountName: zwytest_subaccount_0
              required:
              - subAccountId
              - subAccountName
              properties:
                subAccountId:
                  type: string
                  description: 子账户id
                subAccountName:
                  type: string
                  description: "子账户名称</br>\r\n长度不超过128位"
            examples:
              Example 1:
                value:
                  subAccountId: '2025111833785290'
                  subAccountName: test
  /gateway/vcc-api/subaccount/list:
    post:
      summary: 查询子账户列表
      tags:
      - Gateway
      responses:
        '200':
          description: OK
          headers:
            header-0:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    code: 100001
                    data:
                      total: 1
                      list:
                      - subAccountName: zwytest_subaccount_0
                        subAccountId: '2025111833785290'
                        accountList:
                        - amount: '0.00'
                          acctNo: '2025111833786136'
                          currency: USD
                          frozenAmount: '0.00'
                        status: VALID
                    success: true
                    message: SUCCESS
                properties:
                  code:
                    type: integer
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                      list:
                        type: array
                        items:
                          type: object
                          properties:
                            subAccountName:
                              type: string
                              description: 子资金账户名称
                            subAccountId:
                              type: string
                              description: 子资金账户id
                            accountList:
                              type: array
                              description: 账单币种账户列表
                              items:
                                type: object
                                properties:
                                  amount:
                                    type: string
                                    description: 可用金额，单位：元
                                  currency:
                                    type: string
                                    description: 账单币种，参考ISO currency code
                                  frozenAmount:
                                    type: string
                                    description: 待出账金额：已发生授权但尚未出账的金额，单位：元
                            status:
                              type: string
                              description: "子账户状态\r\n- VALID 有效\r\n- CANCEL 注销"
                  success:
                    type: boolean
                  message:
                    type: string
              examples:
                Example 1:
                  value:
                    code: 100001
                    data:
                      total: 1
                      list:
                      - subAccountName: test
                        subAccountId: '2025111833785290'
                        accountList:
                        - amount: '0.00'
                          currency: USD
                          frozenAmount: '0.00'
                        status: VALID
                    success: true
                    message: SUCCESS
      operationId: post-gateway-vcc-api-subaccount-list
      x-stoplight:
        id: rgiy0sc0kcfn3
      description: "Sandbox : https://test-global-api.lianlianpay-inc.com\r\n\r\nProd    : https://global-api.lianlian.com"
      parameters:
      - schema:
          type: string
        in: header
        name: 'Authorization:'
        description: Basic {token}
      - schema:
          type: string
        in: header
        name: 'LLPAY-Signature:'
        description: t={REQUEST_EPOCH},v={payload}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-examples:
                Example 1:
                  subAccountId: '2025111833785290'
              required:
              - subAccountId
              properties:
                subAccountId:
                  type: string
                  description: 子账户id
                subAccountName:
                  type: string
                  x-stoplight:
                    id: j0oesl1aj0hkw
                  description: 子账户名称
                pageNo:
                  type: string
                  x-stoplight:
                    id: tfdejpsyvbltd
                  description: 页码
                pageSize:
                  type: string
                  x-stoplight:
                    id: 5smtecgfbd35x
                  description: 分页大小
            examples:
              Example 1:
                value:
                  subAccountId: '2025111833785290'
  /gateway/vcc-api/subaccount/cancel:
    post:
      summary: 注销子账户
      tags:
      - Gateway
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    code: 100001
                    data: true
                    success: true
                    message: SUCCESS
                properties:
                  code:
                    type: integer
                  success:
                    type: boolean
                  message:
                    type: string
              examples:
                Example 1:
                  value:
                    code: 100001
                    success: true
                    message: SUCCESS
      operationId: post-gateway-vcc-api-subaccount-cancel
      x-stoplight:
        id: gjxdonjftk0yo
      description: "Sandbox : https://test-global-api.lianlianpay-inc.com\r\n\r\nProd    : https://global-api.lianlian.com"
      parameters:
      - schema:
          type: string
        in: header
        name: 'Authorization:'
        description: Basic {token}
      - schema:
          type: string
        in: header
        name: 'LLPAY-Signature:'
        description: t={REQUEST_EPOCH},v={payload}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-examples:
                Example 1:
                  subAccountId: '2025111833785290'
              required:
              - subAccountId
              properties:
                subAccountId:
                  type: string
                  description: 子账户id
            examples:
              Example 1:
                value:
                  subAccountId: '2025111833785290'
  /gateway/vcc-api/card POST:
    parameters: []
    post:
      summary: 申请卡
      operationId: post-vcc-apply-card
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    code: 100001
                    data:
                      cardId: '2024110661353586'
                    success: true
                    message: SUCCESS
                required:
                - code
                - success
                - message
                properties:
                  code:
                    type: integer
                    description: 响应码
                  data:
                    type: object
                    properties:
                      cardId:
                        type: string
                        description: 卡唯一识别号
                  success:
                    type: boolean
                    description: 成功标识
                  message:
                    type: string
                    description: 响应描述
              examples:
                Example 1:
                  value:
                    code: 100001
                    data:
                      cardId: '2023092284439339'
                    success: true
                    message: SUCCESS
        '400':
          description: Missing Required Information
        '409':
          description: Email Already Taken
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - currency
              - cardName
              - email
              - settleCurrencyCode
              - cardBinName
              properties:
                currency:
                  type: string
                  description: 基础币种（充值币种），支持USD/CNY等，具体结合业务场景和连连侧线下沟通确认开通
                cardName:
                  type: string
                  description: 自定义卡片名称，可使用交易对手名称或订单编号等
                email:
                  type: string
                  description: 联系邮箱，用于接收该卡的额度变动通知
                expiryDate:
                  type: string
                  description: 卡有效期，格式：MMYY，建议不超过4年11个月，例如 0426指的是  26年4月份过期
                settleCurrencyCode:
                  type: string
                  x-stoplight:
                    id: dneqj6v6pypdu
                  description: 结算币种，只有使用特殊卡bin，才会用到该字段
                cardBinName:
                  type: string
                  x-stoplight:
                    id: gcm11tqsi3iyg
                  description: 卡BIN，6位纯数字</br>可登陆越达卡后台点击申卡查看可选卡BIN
                tradeSceneCode:
                  type: string
                  x-stoplight:
                    id: 2ihaz5bqhfxnc
                  description: "交易场景编码，CNY卡必传\r\n<br>\r\ntrade_scene_code\ttrade_scene <br>\r\n001\t因公差旅<br>\r\n002\t商标注册<br>\r\n003\tEPR<br>\r\n004\t律师费<br>\r\n005\t旅游服务费用<br>\r\n006\t网络游戏测试费<br>\r\n007\t商务旅行费用<br>\r\n008\t旅游签证费用<br>\r\n009\t航空机票费用<br>\r\n010\t物流费用<br>\r\n011\t广告费用<br>\r\n012\t技术服务费<br>\r\n013\t一年以上留学/研学教育<br>\r\n014\t一年（含）以内留学/研学教育<br>\r\n015\t留学/研学服务佣金<br>"
                cardLimitRules:
                  type: object
                  x-stoplight:
                    id: xwnd8to0uvn0j
                  description: 卡限制规则
                  properties:
                    enableTransactionCurrencyControl:
                      type: boolean
                      x-stoplight:
                        id: cut4zuan1rwb2
                      description: 是否开启交易币种限制
                    limitTransactionCurrencies:
                      type: array
                      x-stoplight:
                        id: s78uskun5n2bq
                      description: "限制币种范围<br>\r\n打开交易币种限制开关时，集合非空<br>\r\n关闭交易币种限制开关时，为null"
                      items: {}
                    enableTransactionCountControl:
                      type: boolean
                      x-stoplight:
                        id: k959t01vv8dvo
                      description: "是否开启交易次数限制<br>\r\ntrue：开启控制  false：关闭控制"
                    limitTransactionCount:
                      type: integer
                      x-stoplight:
                        id: 410xnw23n318i
                      description: "交易限制次数<br>\r\n打开交易次数限制开关时，次数为非负整数()<br>\r\n关闭交易次数限制开关时，不传或传null<br>"
                    mccCodes:
                      type: array
                      x-stoplight:
                        id: d6w4y9m9x4o0x
                      description: "MCC加白列表<br>\r\n每个元素4位数字，最多20个<br>"
                      items:
                        x-stoplight:
                          id: v3r2u4p7s4b4a
                        type: string
                    fuzzyMerchantNames:
                      type: array
                      x-stoplight:
                        id: 410xnw23n318i
                      description: "商户名称加白列表(模糊匹配)<br>\r\n每个最长40字符，最多20个<br>"
                      items:
                        x-stoplight:
                          id: e6m0k4m0w3h4u
                        type: string
                cardTags:
                  type: array
                  x-stopligh

# --- truncated at 32 KB (156 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lianlian-global/refs/heads/main/openapi/lianlian-global-gateway-api-openapi.yml