分类
外汇免费模拟账户

交易格式和支付金额

请求报文体参数

数据对账(商户平台)

5.10 数据对账(商户平台) 对账对账文件以支付平台对账日期为基准,生成支付平台指定对账日期内所有交易相关记录,故该接口数据可直接用于生成财务结算数据。1个对账文件内可能包含1-2个自然交易日期的交易记录,请商户在与自身平台自然交易日期内所有交易数据核对时注意此情况。 交易格式和支付金额 5.10.1 接口地址 http://pay.soopay.net/spay/pay/payservice.do 5.10.2 请求数据列表 NO. 字段 名称 长度 说明 交易格式和支付金额 必填 协议参数 1 service 接口名称 变长 32 download_settle_file Y 2 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 3 sign 签名 变长256 参见签名机制 Y 4 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 5 version 版本号 定长3 定值 4.0 交易格式和支付金额 Y 业务参数 1 settle_date 对账日期 定长8 商户的对账报表和对账报表均以此日期为准,格式为YYYYMMDD Y 说明:对账数据是每天早上7:00开始生成,于9:00左右生成结束,请各商户于9:00以后获取昨天的对账记录。 5.10.3 请求数据样例 一. 商户请求平台示例:

5.10.4 交易格式和支付金额 对账文件内容说明 响应数据说明 对账文件下载时,将以http文件流的形式响应给接口调用者。

平台响应数据格式说明: 平台响应数据为对账文件,供商户下载。 文件格式说明:

  1. 文件头是一行记录,每笔交易对应文件中的一行,每个数据域用“,”分割;最后一行是汇总信息
  2. 文件头信息(第一行): TRADEDETAIL-START,商户号(mer_id),对账日期(settle_date),版本号(version),返回码(ret_code),返回信息(ret_msg) [回车换行]
  3. 每笔交易:商户号(mer_id),商品号(goods_id),手机号(mobile_id),订单号(order_id),定单日期(mer_date),支付日期(pay_date),金额(amount),付款类型(amt_type),银行类型(gate_id),对账日期(settle_date),交易类型(trans_type),交易状态(trans_state),银行对账状态(bank_check),支付产品编号(product_id) ,退费流水号(refund_no) , 交易成功时间(trans_time) [回车换行] 文件汇总信息(最后一行):TRADEDETAIL-END,商户号(mer_id),交易日期(settle_date),总笔数,总金额 对账文件字段说明 NO. 字段 名称 说明 1 mer_id 商户号 平台统一分配的商户号 2 goods_id 商品号 商户下单时提交的goods_id 3 mobile_id 手机号码 用户支付时使用的手机号码 4 order_id 订单号 商户下单时提交的order_id 5 mer_date 订单日期 商户下单时提交的mer_date 6 pay_date 支付日期 用户确认支付的日期 7 交易格式和支付金额 amount 金额 交易金额,以分为单位 8 amt_type 付款类型 01:人民币 02:移动话费 03:移动积分 9 gate_id 银行类型 网银类交易用户使用的银行 10 settle_date 对账日期 交易的对账日期 11 trans_type 交易类型 01:消费 20:退款 12 trans_state 交易状态 0:初始 1:成功 交易格式和支付金额 -1:失败(一般情况下对账文件只出成功交易) 13 bank_check 银行对账状态 0:初始 1:对账成功 -1:对账失败 14 product_id 支付产品编号 联动定义的支付产品 15 refund_no 退款流水 退款交易此字段有值。退款时由商户生成的退款流水 16 trans_time 交易成功时间 最后交易时间

5.10.5 对账文件内容样例 对账文件名称:6374_20130807.txt 文件内容:

TRADEDETAIL-START,6374,交易格式和支付金额 20130807,v4.0,0000,生成对账文件成功 6374,2012,15001052294,187236111,20130807,20130807,1,01,12,20130807,01,1,0,P1150000,,153915 6374,12345678,15901357692,839372,20130807,20130807,1,交易格式和支付金额 01,12,20130807,01,1,0,P1350000,,154656 6374,1233333,13798208090,2013032118,20130321,20130803,19000,01,12,交易格式和支付金额 20130803,20,1,0,P1550000,1308030938028731,182134 6374,444,18600439818,00014658950,20130502,20130803,93800,01,12,20130803,20,1,0,P1550000,1308031906076716,211312 TRADEDETAIL-END,6374,20130807,2,2

交易格式和支付金额

    发卡机构 收单机构 服务商 商户 查看全部

文档中心 接口列表 行业支付前置平台

接口描述

请求方式

生产调用地址

测试调用地址

请求报文体参数

交易格式和支付金额 交易格式和支付金额 交易格式和支付金额 交易格式和支付金额
中文名称英文名称 域类型 域长度 默认值 请求要求 备注
商户id svcId string 30 M-必填 公共请求参数,接入方的商户代码
接口id svcApi string 100 M-必填 公共请求参数,接入方调用的api的唯一标识
服务商id serId string 30 O-选填 公共请求参数,接入方的服务商代码
报文格式 format string 10 O-选填 公共请求参数,报文格式,目前仅支持json
编码格式 charset string 10 O-选填 公共请求参数,报文使用的编码格式,目前仅支持utf-8
签名方法 signType string 10 M-必填 公共请求参数,接入方生成签名字符串所使用的签名算法类型,目前仅支持 RSA2和RSA,推荐使用RSA2
签名 sign string M-必填 公共请求参数,签名字符串 交易格式和支付金额
交易发起时间 timestamp string 14 M-必填 公共请求参数,默认填写当前时间,格式固定是 " yyyyMMddHHmmss "。针对查询交易,需要上送被查询交易的交易时间
api版本号 version string 11 M-必填 公共请求参数,调用api接口的版本,默认是 "交易格式和支付金额 2.0.0"。如果不是,会有特殊说明。
后台通知地址 notifyUrl string 256 O-选填 公共请求参数,商户后台通知地址
业务请求报文 bizContent string M-必填 公共请求参数,除公共参数外所有请求参数都必须放在这个参数中传递,具体请参照各业务请求参数。整个bizContent中的数据作为一个json字符串来上送。
交易类型 transTp int 2 M-必填 03
交易子类型 subTransTp int 4 M-必填 0301-被扫消费
商户订单号 mchntOrderId string 40 M-必填 聚合业务上送8-32位
商品详细信息 body string 255 M-必填
交易金额 transAt int 12 M-必填 以分为单位
支付二维码 qrNo string 19 M-必填 支持银联、支付宝、微信二维码,长度16-19位
商户保留域 mchntResvstring 1024 O-选填 原路返回
终端ip mchCreateIp string 15 M-必填 公网ip非内网ip
设备号 deviceInfo string 8 O-选填 终端设备号
微信子应用id weChatSubAppId string 255O-选填 微信公众平台基本配置中的AppID(应用ID),传入后支付成功可返回对应公众号下的用户openid
电子发票【微信】 needReceipt boolean O-选填 需要和微信公众平台的发票功能联合,传入true时,微信支付成功消息和支付详情页将出现开票入口[新增need_receipt【适用于微信】]
单品信息 goodsDetail string 6000 O-选填 单品优惠活动该字段必传,详见单品优惠说明
商品标记 goodsTag string 32 O-选填 商品标记
订单超时时间 timeExpire string 14 O-选填 订单失效时间

同步应答参数

示例代码

在线支付简介

Internet businesses are required to collect indirect taxes in over 130 countries and in most US states; however, staying compliant can be challenging, especially as your business scales. Tax rules and rates change constantly and vary based on what and where you sell. If you ignore these complexities, you risk paying penalties and interest on top of uncollected taxes.

Indirect taxes have various names around the world. Indirect tax is called sales tax in the US, value-added tax (VAT) in Europe, goods and services tax (GST) in Australia and Canada, and consumption tax (JCT) in Japan. The process for collecting these taxes can vary significantly, but the outcome is the same: The end customer pays the tax.

Tax treatments depend on whether you sell a physical or digital product. For physical goods, the tax treatment depends on the ship-from and ship-to locations, plus how each jurisdiction categorizes 交易格式和支付金额 the product. There are many differences across city, state, and country lines. Digital products (such as online courses or website memberships) can be just as complex. In the US, 40 states tax digital goods, and in the EU, digital products are taxable if they fit certain criteria.

No matter what you are selling, you’ll need to answer these questions to comply with sales tax, VAT, and GST:

  • Where and when am I obligated to collect taxes?
  • How do I register to collect taxes?
  • How much tax should I charge on each product or service?
  • How do I file and remit the money I collect?

For more information about these taxes, read our guides:

Stripe Tax automatically calculates and collects sales tax, VAT, and GST on both physical and digital goods and services in all US states and more than 30 countries. Learn more.

线上零售商

越来越多一开始只在网上经营的零售商通过开设线上售卖点成功拓展到了现实世界。有超过 90% 的购物仍然是现场进行的,这便为数字企业创造了打造新收入流的潜力。

1. 利用现有基础设施

2. 支持芯片卡和移动钱包

Stripe 磁条卡增加了商家的风险,因为欺诈者很容易复制磁条卡,并且需要额外的步骤来加密客户的支付信息。因此,几十年来,EMV 芯片卡一直充当着全球标准——这种卡更安全,在发生欺诈时可以保护企业免受损失。

还要考虑支持移动钱包,如 Apple Pay 和 Google Pay,用于面对面交易。和芯片卡一样,它们可以安全地加密支付信息,并最大限度地减少您与欺诈交易相关的责任。移动钱包还改善了支付体验,使交易对客户更方便和简化。

SaaS 及订阅公司

以下是 SaaS 和订阅付款的三个注意事项:

1. 设置灵活的订阅逻辑

订阅逻辑包括基于时间和基于价格的规则,通过两者以预定的节奏准确向客户收款。如果您只有一个产品和简单的定价,比如软件订阅费每月 25 美元,那么在您的计费系统中可以很容易的设置这个逻辑,因为美元金额不会逐月变化。

2. 考虑您的账单需求

如果您向客户收取大额费用,或者发送一次性账单,则客户通常偏向于收取账单(对于拥有其他公司客户的 SaaS 公司来说,这两种情况都很常见)。

3. 最小化非自愿性流失率

多数 SaaS 和订阅公司都会面临非自愿性流失的问题,这是指客户原本打算为某一个产品付费,但由于银行卡过期、资金不足或银行卡信息过期导致付款尝试失败了(非自愿性流失使得首次收款尝试时 9% 的订阅账单支付失败)。

平台和交易市场

如果您是软件平台并让其他公司直接向他们的客户收款(例如 Shopify),或如果您是交易市场,由您向客户收款,然后发给买家或服务提供者(例如 Lyft),则请阅读本节内容。

平台和交易市场有着一些最为复杂的支付要求,因为它们代表卖家或服务提供者收款,并为他们安排提现。因此,这会涉及到很多独特的考虑因素,包括验证卖家的身份、以合规的方式管理资金的转移、从每次付款中收取服务费,以及在适用时向美国国税局提交 1099 税表。

传统上,添加支付功能需要您获得许可,并在卡组织(如 Visa、Mastercard、Discover 或 American Express)注册并保留支付服务商的身份。因为当您在买卖双方之间转移资金时,会视为您在控制资金流动,所以信用卡组织要实行严格的规定。这一流程可能需要几个月(有时几年),需要数百万美元的前期和持续成本。

1. 入驻时验证用户

代您的卖家或商家收任何钱之前,您需要先将他们注册到您的支付系统并验证他们的身份。由于严格的法律法规,包括客户身份验证 (KYC) 法规和制裁筛查要求,这个步骤非常复杂,会对违规行为进行处罚和罚款。除了各国不同的政府法规外,包括 Visa、Mastercard、Discover 和 交易格式和支付金额 American Express 在内的信用卡组织也有自己的信息收集要求,并会定期更新。

2. 支持不同的货币转移方式

向您的用户付款不仅涉及将钱从 A 点转移到 B 点。您还要具备为您的平台收取服务费、在卖家之间分割和发送资金以及向卖家的银行账户提现时进行控制的能力。

假设您经营着一个电子商务平台,某客户从一个卖家那里花了 50 美元。您需要考虑三方主体:您的平台、您的卖家或服务提供者,以及他们的买家或最终用户。在您付钱给卖家之前,您需要先提取您的平台费用。然后,您需要弄清楚如何以及何时将剩余资金发给卖家。您是在收到商品或服务后立即支付,还是每周汇总资金后再支付?您有正确的银行信息来安排付款吗?

  • 一对一: 一个顾客付费,一个收款人收款(例如拼车服务)。
  • 一对多: 一笔交易在多个卖家或收款人之间进行分割(例如,在一个零售平台中,一个顾客购买的一“购物车”的商品来自多个在线商店)。
  • 保管资金: 平台从客户那里接收资金并在储备金中保管,然后再付给收款人(例如票务平台,只在活动举行完之后才付款给收款人)。
  • 账户借记: 平台执行借记或交易冲销操作,以从其卖家或服务提供者那里提取资金(例如,电子商务平台从其商家客户那里提取每月的店铺维护费)。
  • 订阅: 平台允许卖家向客户收取经常性费用(例如,一个 SaaS 平台允许其非营利组织接受经常性捐赠)。

Stripe Connect 使平台和交易市场能够为其卖方、服务提供商以及客户提供支付便利。它支持入驻和验证,允许您在全球范围内接受 135 种以上的货币和数十种本地支付方式,内置欺诈保护,为用户提现,并跟踪资金流向。

交易格式和支付金额

Payment

查询条件如下:App,Time,State,Currency,Merchant order No.,Paynicorn order No.,User ID;

查询条件如下:App,Time,State,Currency,Merchant order No.,Paynicorn order No.,User ID;选择对应的查询条件后,点击“OK”显示对应的查询结果