馈送 API

与LOVAT系统进行技术集成的说明

术语和缩写

API – 应用程序编程接口。系统提供的一组调用,用于与外部软件产品集成。

商户 – 在线商店的所有者。

客户 – 支付商品或服务费用的个人。

交易 – 客户从商户处收到商品或服务时的资金转移。

令牌 – 系统用来识别商户和注册交易的网站的秘密字符串。

API描述

发送方法(Send method)。

方法描述。

发送方法实现了交易数据的接收,包括增值税(VAT)和系统费用的处理和计算。

引用URL

该方法可通过以下URL访问:

https://merchant.vatcompliance.co/api/1/
send/{access_token}?if_digital={true/false}&if_vat_calculate={true/false}

调用选项

调用参数分为两种类型:

  • 路径参数(令牌)
  • 查询参数(交易数据)

令牌在添加网站的第一阶段由商户的内部账户生成。您可以从您的经理处获得或在“商店 – 设置”部分中找到。

请求参数由商户生成,并使用POST方法发送到服务器,
格式为 
/ x-www-form-urlencoded 或 application / json

数字服务

参数 类型/示例 示例说明 验证
transaction_id 字符串/ 555-yyy 交易ID 最多255个字符。不能为空。
transaction_datetime 日期时间 / 2017-01-09T08:27:22 +00:00 根据ISO 8601 GMT格式的交易日期和时间 不能为空。
transaction_sum 字符串 / 25 交易金额 最多45个字符。不能为空。
customer_ip 字符串 / 127.0.0.1 客户IP地址 最多45个字符。
currency 字符串 / “usd”, “eur”, “rub”, “gbp” 交易货币 最多3个字符。不能为空。
customer_phone_number 字符串 / “+7 AAA BBB BB BB” 客户电话号码 最多100个字符。
arrival_country 字符串 / “GBR” 根据ISO 3166-1 alpha-3格式的国家代码 最多3个字符。
arrival_city 字符串 / “London” 到达城市 最多255个字符。
arrival_address_line 字符串 / “Peckham Road” 到达地址 最多255个字符。
transaction_status

字符串 / “Success”, “Charge back”, “refund”,

“Movement own goods”

交易状态 不能为空。
service_code 字符串 / “1”

商户服务类型代码。如果商户未提供服务类型数据,交易将被分配为注册时指定的商户服务的主要类型。

 

最多255个字符。不能为空。
bank_card_number 字符串 / “1234-****-****-****” 买家的银行卡号 最多19个字符。
payment_operator 字符串 / “payonline” paypal” 支付运营商 最多45个字符。不能为空。
payment_method_country 字符串 / “USA” 支付方式所属国家。根据ISO 3166-1 alpha-3格式指定的国家 最多3个字符。不能为空。
billing_country 字符串 / “USA” 账单国家(付款所有者地址)。根据ISO 3166-1 alpha-3格式指定的国家 最多3个字符。不能为空。
billing_address 字符串 / “111 First Street,Saratoga, CA 95070, US” 账单地址(付款所有者地址) 最多255个字符。不能为空。

服务器响应代码

查询的响应使用基本HTTP代码

代码 说明 响应内容
200 OK 请求已处理
400 BadRequest 无效请求 { error : “数据有问题” }
401 Unauthorized 未授权访问 { error : “令牌无效。” }

数字服务的示例查询:
控制台的示例请求

curl -v POST 'https://merchant.vatcompliance.co/api/1/
send/5aae918d97964ff88df64b059c2cc0f8?if_digital=false&if_vat_calculate=true' --header "Content-Type: application/json"
-d '{ 
    "transaction_id": "ttt4565-85546",
    "transaction_datetime": "2017-01-09T08:27:22 +00:00",
    "transaction_sum": 25.99,
    "customer_ip": "127.0.0.1",
    "customer_phone_number": "+7 677 ** * **",
}'

商品

参数 类型/示例 示例说明 验证
transaction_id 字符串/ 555-yyy 交易ID 最多255个字符。不能为空。
transaction_datetime 日期时间 / 2017-01-09T08:27:22 +00:00 根据ISO 8601 GMT格式的交易日期和时间 不能为空。
transaction_sum 字符串 / 25 交易金额 最多45个字符。不能为空。
currency

字符串 / “GBP”,

“EUR”, “RUB”

所有货币均按照ISO 4217标准表示 最多3个字符。不能为空。
arrival_country 字符串 / “GBR” 根据ISO 3166-1 alpha-3格式的国家代码 最多3个字符。
arrival_city 字符串 / “London” 到达城市 最多255个字符。
arrival_address_line 字符串 / “Peckham Road” 到达地址 最多255个字符。
transaction_status

字符串 / “Success”, “Charge back”, “refund”,

“Movement own goods”

交易状态 不能为空。
good_code 字符串 / “62160000” 根据欧盟的八位数字编码系统(合并命名法,CN)的商品代码 最多8个字符。
vat_percent 浮点数 / 20.00 增值税百分比 最多8个字符。
vat 浮点数 / 28.73 增值税金额 浮点数
departure_country 字符串 / “AUS” 根据ISO 3166-1 alpha-3格式的国家代码 最多3个字符。不能为空。
taxable_jurisdiction 字符串 / “GBR” 根据ISO 3166-1 alpha-3格式的国家代码 最多3个字符。
buyer_vat_number 字符串 / “UK123123123” 买方的欧盟增值税号码 最多255个字符。

商品的示例查询:
控制台示例请求

curl -v POST
https://merchant.vatcompliance.co/api/1/send/5aae918d97964ff88df64b059c2cc0f8?if_digital=false&if_vat_calculate=false
--header "Content-Type: application/json" 
-d '{
                "transaction_id": "ttt4565-85546",
                "transaction_datetime": "2017-01-09T08:27:22 +00:00",
                "transaction_sum": 158.04,
                "currency": "GBP",
                "arrival_country": "GBR",
                "arrival_city": "London",
                "arrival_address_line": "Peckham Road",
                "transaction_status": "Success",
                "good_code": "62160000",
                "vat_percent": 20.00,
                "vat": 28.73,
                "departure_country": "AUS",
}'

服务代码列表

音频/视频内容 1
实时流媒体 2
电话服务 3
网络电话服务 4
呼叫管理服务 5
寻呼服务 6
互联网接入 7
图片 8
音乐 9
游戏 10
电子报纸 11
网站托管 12
程序的远程维护 13
网站广告空间 14
电子书 15
许可证 16
约会 17
远程教育 18
赌博 19
商品供应 20
其他数字服务 21

订阅我们的通讯

有一只小蓝鹦鹉已经报名,所以它在税务系统中取得了成功

订阅