icbc

Documentation

Index

• Constants
• Variables
• type BizErr
  • func (e *BizErr) Error() string
• type Client
  • func NewClient(merId, appId, serialNo, clearingAccount, privateKey, publicKey string, ...) (*Client, error)
  • func (c *Client) GetNotifyRsp(code int, msg, srcMsgId string) (rsp string, err error)
  • func (c *Client) Pay(ctx context.Context, bm gopay.BodyMap) (rsp *PayRsp, err error)
  • func (c *Client) Query(ctx context.Context, bm gopay.BodyMap) (rsp *PayQueryRsp, err error)
  • func (c *Client) Refund(ctx context.Context, bm gopay.BodyMap) (rsp *RefundRsp, err error)
  • func (c *Client) VerifyNotifySign(path string, bm gopay.BodyMap) (err error)
• type NotifyReq
• type NotifyRsp
• type NotifyRspCommon
• type PayQueryRsp
• type PayRsp
• type RefundRsp
• type RspBase
• type RspCommon

Constants

const (
	RSA  = "RSA"
	RSA2 = "RSA2"
)

Variables

var (
	DefaultLocation, _ = time.LoadLocation("Asia/Shanghai")
)

Types

type BizErr

type BizErr struct {
	Code string `json:"code"`
	Msg  string `json:"msg"`
}

BizErr 用于判断业务逻辑是否有错误

func (*BizErr) Error

func (e *BizErr) Error() string

type Client

type Client struct {
	// contains filtered or unexported fields
}

func NewClient

func NewClient(merId, appId, serialNo, clearingAccount, privateKey, publicKey string, isProd bool) (*Client, error)

NewClient 初始化工行客户端 merId：商户编号 appId：商户的工行APPID serialNo：收单产品协议编号 clearingAccount：商户清算账号 privateKey：商户的私钥 publicKey：工行网关的公钥 publicKey：是否正式环境

func (*Client) GetNotifyRsp

func (c *Client) GetNotifyRsp(code int, msg, srcMsgId string) (rsp string, err error)

获取回调通知返回

func (*Client) Pay

func (c *Client) Pay(ctx context.Context, bm gopay.BodyMap) (rsp *PayRsp, err error)

Pay 聚合支付接口（bm只需传入biz_content参数）

func (*Client) Query

func (c *Client) Query(ctx context.Context, bm gopay.BodyMap) (rsp *PayQueryRsp, err error)

Query 聚合支付查询接口（bm只需传入biz_content参数）

func (*Client) Refund

func (c *Client) Refund(ctx context.Context, bm gopay.BodyMap) (rsp *RefundRsp, err error)

Refund 统一退款接口（bm只需传入biz_content参数）

func (*Client) VerifyNotifySign

func (c *Client) VerifyNotifySign(path string, bm gopay.BodyMap) (err error)

回调通知验证签名

type NotifyReq

type NotifyReq struct {
	RspBase
	CardNo       string `json:"card_no"`
	MerId        string `json:"mer_id"`
	TotalAmt     string `json:"total_amt"`
	PointAmt     string `json:"point_amt"`
	EcouponAmt   string `json:"ecoupon_amt"`
	MerDiscAmt   string `json:"mer_disc_amt"`
	CouponAmt    string `json:"coupon_amt"`
	BankDiscAmt  string `json:"bank_disc_amt"`
	PaymentAmt   string `json:"payment_amt"`
	OutTradeNo   string `json:"out_trade_no"`
	OrderId      string `json:"order_id"`
	PayTime      string `json:"pay_time"`
	TotalDiscAmt string `json:"total_disc_amt"`
	Attach       string `json:"attach"`
	ThirdTradeNo string `json:"third_trade_no"`
	CardFlag     string `json:"card_flag"`
	DecrFlag     string `json:"decr_flag"`
	OpenId       string `json:"open_id"`
	PayType      string `json:"pay_type"`
	AccessType   string `json:"access_type"`
	CardKind     string `json:"card_kind"`
}

异步回调通知响应体参数

type NotifyRsp

type NotifyRsp struct {
	ReturnCode int    `json:"return_code"`
	ReturnMsg  string `json:"return_msg"`
	MsgId      string `json:"msg_id"`
}

异步回调通知返回响应体参数

type NotifyRspCommon

type NotifyRspCommon struct {
	ResponseBizContent json.RawMessage `json:"response_biz_content"` // 响应业务参数
	SignType           string          `json:"sign_type"`            // 签名类型
	Sign               string          `json:"sign"`                 // 针对返回参数集合的签名
}

异步回调通用返回参数

type PayQueryRsp

type PayQueryRsp struct {
	RspBase
	PayStatus             string `json:"pay_status"`
	CardNo                string `json:"card_no"`
	MerId                 string `json:"mer_id"`
	TotalAmt              string `json:"total_amt"`
	PointAmt              string `json:"point_amt"`
	EcouponAmt            string `json:"ecoupon_amt"`
	MerDiscAmt            string `json:"mer_disc_amt"`
	CouponAmt             string `json:"coupon_amt"`
	BankDiscAmt           string `json:"bank_disc_amt"`
	PaymentAmt            string `json:"payment_amt"`
	OutTradeNo            string `json:"out_trade_no"`
	OrderId               string `json:"order_id"`
	PayTime               string `json:"pay_time"`
	TotalDiscAmt          string `json:"total_disc_amt"`
	Attach                string `json:"attach"`
	ThirdTradeNo          string `json:"third_trade_no"`
	CardFlag              string `json:"card_flag"`
	DecrFlag              string `json:"decr_flag"`
	OpenId                string `json:"open_id"`
	PayType               string `json:"pay_type"`
	AccessType            string `json:"access_type"`
	CardKind              string `json:"card_kind"`
	ThirdPartyCouponAmt   string `json:"third_party_coupon_amt"`
	ThirdPartyDiscountAmt string `json:"third_party_discount_amt"`
	OutTradeNoWx          string `json:"out_trade_no_wx"`
	ReturnCodeWx          string `json:"return_code_wx"`
	Appid                 string `json:"appid"`
	BankType              string `json:"bank_type"`
	CashFee               string `json:"cash_fee"`
	FeeType               string `json:"fee_type"`
	IsSubscribe           string `json:"is_subscribe"`
	MchId                 string `json:"mch_id"`
	NonceStr              string `json:"nonce_str"`
	ResultCode            string `json:"result_code"`
	Sign                  string `json:"sign"`
	TimeEnd               string `json:"time_end"`
	TotalFee              string `json:"total_fee"`
	TradeType             string `json:"trade_type"`
	TransactionId         string `json:"transaction_id"`
	SignType              string `json:"sign_type"`
	Body                  string `json:"body"`
	SpbillCreateIp        string `json:"spbill_create_ip"`
	NotifyUrl             string `json:"notify_url"`
	UnionDiscountAmt      string `json:"union_discount_amt"`
	UnionMchtDiscountAmt  string `json:"union_mcht_discount_amt"`
}

PayQueryRsp 通用支付查询响应参数

type PayRsp

type PayRsp struct {
	RspBase
	TotalAmt         string `json:"total_amt"`          // 订单总金额
	OutTradeNo       string `json:"out_trade_no"`       // 商户系统订单号，原样返回
	OrderId          string `json:"order_id"`           // 工行订单号
	PayTime          string `json:"pay_time"`           // 支付完成时间，格式为：yyyyMMdd
	MerId            string `json:"mer_id"`             // 商户编号
	PayMode          string `json:"pay_mode"`           // 支付方式
	AccessType       string `json:"access_type"`        // 收单接入方式
	CardKind         string `json:"card_kind"`          // 卡种
	TradeType        string `json:"trade_type"`         // 支付方式为微信时返回，交易类型
	WxDataPackage    string `json:"wx_data_package"`    // 支付方式为微信时返回，微信数据包，用于之后唤起微信支付
	ZfbDataPackage   string `json:"zfb_data_package"`   // 支付方式为支付宝时返回，支付宝数据包，用于之后唤起支付宝支付
	UnionDataPackage string `json:"union_data_package"` // 支付方式为云闪付时返回，云闪付受理订单号，用于之后进行银联云闪付支付
}

PayRsp 通用支付响应参数

type RefundRsp

type RefundRsp struct {
	RspBase
	IntrxSerialNo string `json:"intrx_serial_no"` // 退货工行流水号
}

RefundRsp 退款响应

type RspBase

type RspBase struct {
	ReturnCode           string `json:"return_code"`
	ReturnMsg            string `json:"return_msg"`
	MsgId                string `json:"msg_id"`
	ThirdPartyReturnCode string `json:"third_party_return_code"` // 第三方报错时返回的报错码
	ThirdPartyReturnMsg  string `json:"third_party_return_msg"`  // 第三方报错时返回的报错信息
}

响应参数

type RspCommon

type RspCommon struct {
	ResponseBizContent json.RawMessage `json:"response_biz_content"` // 响应参数集合,包含公共和业务参数
	Sign               string          `json:"sign"`                 // 针对返回参数集合的签名
}

通用响应参数