[day9]API就位罗~串接永丰API规划

##API规划
先准备这次消费串接的API,主要需要三支API

  • 订单建置API

    • 目的:
      由网站点选缴费项目,呼叫永丰建立订单交易API(OrderCreate)

    • 代入参数

      1. 客户编号(householder:str)
      2. 订单金额(Amount:int )
        这边需要注意一下,配合规格,实际送出需要加小数点00,举例来说:99元,送出的数值为9900才会正常,但为了纪录方便,程序自动补上小数点後两位00,此参数还是填入整数金额。
      3. 订单编号(OrderNo:str)
        订单编号设计为
           收款方式_+管理费所属年月+_+订单成立时之timestamp
      
      1. 收款方式(PayType:str)
        填入A(ATM 转帐)或C(信用卡)
    • 自动代入

      1. 自填参数一(Param1:str)
        填入客户编号,永丰API才能回传客户资讯。
      2. 自填参数二(Param2:str)
        填入订单编号(年月),永丰API才能回传订单之月份资料。
      3. 自填参数三(Param3:str)
        暂定不填入
      4. 付款截止日期(ExpireDate:str)
        若为ATM付款,设定为订单成立时的日期+一天,表示须於隔日之前完成汇款动作
      5. 付款截止日期(AutoBilling:str)
        自动请款设定(Y=>自动请款,N=>不自动请款),预设Y
  • 订单查询API(以订单编号查询)

    • 目的:
      网站发动以订单编号查询订单状况,即时确认是否已完成订单,呼叫永丰建立订单交易API(OrderQuery),此API属於由商家主动查询订单状态。而OrderPayQuery是永丰主动发动通知,由OrderPayQuery回传token查询结果,需要建置服务让永丰呼叫,待整体架构更完整时再来考虑,暂时不开发此流程。
    • 代入参数
      1. 订单编号(orderNo:str)
        举例:A_20210924_1632450255.946536
    • 回传
      主要需要的回传参数有两项
      1. 处理状态(Status:str)
        确认查询是否正常(S=>处理成功;F=>处理失败)
      2. 订单清单(OrderList:json)
        查询之订单资讯
  • 订单查询API(以日期查询)

    • 目的:
      SERVER以日期查询订单状况,主要目的为查询前两日订单,确认各订单结果,呼叫永丰建立订单交易API(OrderQuery),并将查询结果保留於资料库。
      其中交易日期起迄日配合付款截止日期的两日设定,固定抓取两日前的资讯,批次更新订单资讯。
    • 代入参数
      1. 订单日期(rundate:str)
        -交易日期起日(DateTimeS:str)
        举例:20210923
        -交易日期迄日(DateTimeE:str)
        举例:20210924
    • 回传
      主要需要的回传参数有两项
      1. 处理状态(Status:str)
        确认查询是否正常(S=>处理成功;F=>处理失败)
      2. 订单清单(OrderList:json)
        查询之订单资讯

定义好了,明天就来实作罗


<<:  Day11:全端工程师的基本要求

>>:  Day10|【Git】档案管理 - 删除档案 git rm

JS 04 - 变数类型

大家好! 昨天我们介绍了资料的传递方式,今天就来理解变数的宣告方式吧! 我们进入今天的主题吧! 变数...

从 IT 技术面细说 Search Console 的 27 组数字 KPI (15) :AMP

这篇文章不再讲下面四件事: 甚麽是 AMP? AMP 对网站流量有帮助吗? 要如何做 AMP 或是 ...

Day6 建立 Next.js 专案 - 使用 create-next-app

今天我们要来建立 Next.js 专案,目标是能在自己电脑上成功开启 Next.js 网页。 我预设...

LHS RHS

RHS 字面上来说RightHand Side,不是真的右手的意思...简单来说当作get of v...

予焦啦!BSS 初始化

本节是以 Golang 上游 ee91bb83198f61aa8f26c3100ca7558d30...