通过购买令牌获取支付数据
注意
该门户网站正在开发中。文档的完整版本请看这里.
此方法允许通过购买令牌获取支付信息。
交互参数
GET https://public-api.rustore.ru/public/purchase/{purchaseToken}
属性 | 类型 | 描述 | 必须 | 布局 | 填写示例 |
---|---|---|---|---|---|
Public-Token | string | Public API Rustore的访问令牌 | 是 | header | |
purchaseToken | string | 如何获取购买令牌 | 是 | path | 111.123 |
响应参数
属性 | 类型 | 描 述 | 必须 | 布局 | 填写示例 |
---|---|---|---|---|---|
code | string | 响应代码 | 是 | body | ОК,ERROR,BAD_REQUEST,NOT_FOUND |
message | string | 响应代码解释 | 否 | body | |
timestamp | string | 响应时间 | 是 | body | |
body{} | object | 响应正文 | 否 | body |
body
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
error{} | object | 错误解释 | |
invoice_id | string | 发票号码 | 12345 |
invoice_date | string | 发票创建日期 | 2020-04-29T08:18:03+03 |
invoice_status | string | 发票状态 | created --- 已创建; executed --- 用户选择了支付方式, 支付正在执行; cancelled --- 用户取消; paid --- 资金已预留, 发票等待确认 (只适用于消耗性产品的购买); confirmed --- 支付成功; refunded --- 资金已退还给购买者。 |
invoice{} | object | 发票信息 | |
image | string | 图片链接 | https://i-love-png.com/images/grim-reaper-icon.png |
application_code | string | 应用程序代码 | com.MashaAndTheBear.HairSalon |
application_name | string | 应用程序名称 | 《玛莎和熊》美容院 |
owner_code | string | 应用程序所有者代码 | com.MashaAndTheBear |
owner_name | string | 应用程序所有者名称 | 玛莎和熊 |
payment_info{} | object | 支付信息 | |
payment_methods{} | object | 支付工具 |
body.error
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
user_message | string | 错误文本 | |
error_description | object | 错误描述 | |
error_code | number | 错误的数字代码 | 0 |
body.invoice
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
purchaser{} | object | 关于买方的信息 | |
delivery_info{} | object | 配送信息 | |
invoice_params\[\] | array | 订单的额外参数 | |
order{} | object | 关于订单的信息 |
body.invoice.purchaser
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
email | string | Email买方 | qq@dd.eof |
phone | string | 电话号码 | 9123456789 |
contact | string | 首选的通信方式 |
body.invoice. delivery_info
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
address{} | object | 地址 | |
delivery_type | string | 配送方式 | courier |
description | string | 附加信息 | 在1.5 小时之前回电话 |
body.invoice. delivery_info.address
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
country | string | 国家标识符 | RU |
city | string | 城市 | 莫斯科 |
address | string | 地址 | 瓦维洛娃街19号,办公室1 |
body.invoice.invoice_params []
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
key | string | 参数名称 | packageName |
value | string | 参数值 | com.MashaAndTheBear.HairSalon |
body.invoice.order
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
order_id | string | 订单的唯一标识符 | d290f1ee-6c54-4b01-90e6-d701748f0851 |
order_number | string | 订单号 | 145 |
order_date | string | 订单日期 | 2020-04-29T08:17:03+03 |
service_id | string | 服务标识符 | 223 |
amount | number | 以货币最小单位(戈比)表示的订单金额 | 11836 |
currency | string | 货币代码 | RUB |
purpose | string | 付款的简要目的 | 在游戏"玛莎和熊,美容院魔女"中的购买 |
description | string | 订单描述 | 在游戏"玛莎和熊,美容院魔女"中购买游戏内内容 |
language | string | 语言 | ru-RU |
expiration_date | string | 发票有效期的日期和时间 | 2022-10-11T14:05:44.741Z |
tax_system | number | 税收制度 | 0 |
trade_name | string | 组织的商业名称 | Romashka |
visual_name | string | 操作名称 | 购买/续订订阅 |
org_name | string | 组织名称 | 有限责任公司"甘菊" |
org_inn | string | 组织的纳税人识别号 | 1234567890 |
visual_amount | string | 金额 | 1 500,45 ₽ |
order_bundle \[\] | array | 订单组成 |
body.invoice.order.order_bundle []
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
position_id | number | 唯一产品标识符 | 1 |
name | string | 产品名称或描述 | 水晶 |
item_params\[\] | array | 订单的额外参数 | |
quantity{} | object | 产品总数量的描述 | |
item_amount | number | 所有产品项的价值总额,以货币的最小单位(即戈比)表示 | 11836 |
currency | string | 货币代码 | RUB |
item_code | string | 产品编号(标识符) | com.MashaAndTheBear.HairSalon.crystal100 |
item_price | number | 单个产品的价格,以货币的最小单位表示(即戈比) | 11836 |
discount_type | string | 产品折扣类型 | percent |
discount_value | float | 产品折扣值 | 5.25 |
interest_type | string | 销售产品的代理佣金类型 | agentPercent |
interest_value | float | 销售产品的代理佣金值 | 15.105 |
tax_type | number | 增值税税率 | 6 |
tax_sum | number | 税款总额,以货币的最小单位表示(即戈比) | 2367 |
image | string | 图片链接 | https://i-love-png.com/images/grim-reaper-icon.png |
body.invoice.order.order_bundle.item_params []
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
key | string | 参数名称 | packageName |
value | string | 参数值 | com.MashaAndTheBear.HairSalon |
body.invoice.order.order_bundle.quantity
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
value | float | 含义 | 1.05 |
measure | string | 计量单位 | 公斤 |
body.payment_info
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
payment_date | number | 发票支付日期和时间 | 2022-10-11T14:05:44.741Z |
payment_id | string | 唯一支付标识符 | d290f1ee-6c54-4b01-90e6-d701748f0851 |
payment_params{} | object | 支付的附加参数 | |
device_info{} | object | 设备信息 | |
loyalty_info{} | object | 忠诚计划信息 | |
card_id | string | 银行卡的唯一标识符 | ad454ffg-6c54-4b01-90e6-d701748f0851 |
name | string | 卡别名 | 重要 |
paysys_code | string | RBS-shortname | |
masked_pan | string | 银行卡掩码号 | **1111 |
expiry_date | string | 卡到期日期 | 201912 |
cardholder | string | 卡持有人姓名 | Ivan Petrov |
payment_system | string | 支付系统 | Visa |
payment_system_image | string | 支付系统标志链接 | https://smartmarkettestift.online.sberbank.ru/icons/logo_visa.png |
image | string | 卡标志链接 | https://smartmarkettestift.online.sberbank.ru/icons/sberbank_mastercard_league_legends.jpeg |
paysys | string | 支付运营商名称 | RBS |
paysys_image | string | 支付运营商标志链接 | https://www.sberbank.ru/common/img/uploaded/redirected/s_m_business/acquiring/assets/images/intro@2x.png |
payment_way | string | 支付方式 | SberPay |
payment_way_code | string | 支付方式标识符 | SberPay |
payment_way_logo | string | 支付方式标志链接 | https://cdn1.telegram.one/i/f7640dada78306b1c993e04001b8738d/828b1eb30921659e22e53a9edc92c4c4/24e01830d213d75deb99c22b9cd91ddd |
bank_info{} | object | 银行信息 |
body.payment_info.payment_params
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
key | string | 参数名称 | googlePurchaseToken |
value | string | 参数值 | ameinkbophchljaejnocadib |
body.payment_info. device_info
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
device_platform_type | string | 设备平台 | iOS |
device_platform_version | string | 平台操作系统版本 | 13.6.1 |
device_model | string | 设备型号 | iPhone7 |
device_manufacturer | string | 制造商 | Apple |
device_id | string | 设备序列号 | 83c3f257-46d8-41fe-951b-f79d04e288c2 |
surface | string | RuStore | |
surface_version | string | 软件版本 | 11.5.0 |
body.payment_info.loyalty_info
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
service_code | string | 奖励计划代码 | sbrf_spasibo |
service_name | string | 奖励计划名称 | Sberbank 谢谢 |
change_rate | number | 积分兑换卢布的系数 | 1 |
payment_bonus | number | 使用积分支付发票的金额(以戈比计算) | 19800 |
award_bonus | number | 用于积分计算的资金总额,在支付订单时指明以最小单位(即戈比) | 21850 |
image | string | 图片链接 | https://i-love-png.com/images/grim-reaper-icon.png |
body.payment_info.bank_info
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
bank_name | string | 发行银行名称 | 俄罗斯联邦储蓄银行股份公司 |
bank_country_code | string | 发行银行的国家代码 | RU |
bank_country_name | string | 发行银行的国家名称 | 俄罗斯 |
bank_image | string | 银行标志链接 | https://emoji.slack-edge.com/TKK9DHNCV/sber/ad2df81a6cd9812d.png |
body. payment_methods
属性 | 类型 | 描述 | 填写示例 |
---|---|---|---|
user_message | string | 用户的消息(非必需) | 为了连接订阅,请在移动应用程序中保存您的银行卡信息 |
methods\[\] | array | 支付选项 |
body. payment_methods.methods []
属性 | 类型 | 描述 | 填写 示例 |
---|---|---|---|
method | string | 代码 | QR |
action | string | 名称 | 通过QR码支付 |
示例回复:
{
"code": "OK",
"message": null,
"body": {
"invoice_id": "2850",
"invoice_date": "2023-07-18T14:31:33+03",
"invoice_status": "confirmed",
"application_code": "3399750",
"application_name": "Маша и медведь",
"owner_code": "4384191",
"owner_name": "ООО \"Нарана\"",
"payment_info": {
"payment_date": "2023-07-18T14:31:42+03",
"payment_id": "82022-123456",
"payment_params": null,
"loyalty_info": null,
"card_id": "193",
"paysys_code": "RBS-shortname",
"masked_pan": "XX1111",
"expiry_date": "202412",
"payment_system": "Visa",
"payment_system_image": "https://smartmarket.online.sberbank.ru/image/visa.png",
"paysys_image": null,
"payment_way": "Оплата сохраненной картой",
"payment_way_code": "CARD_BINDING",
"payment_way_logo": "https://static.tildacdn.com/tild6236-3530-4235-b966-326630656238/___14_-removebg-prev.png",
"bank_info": {
"bank_name": "Sberbank",
"bank_country_code": "SU",
"bank_country_name": null,
"bank_image": null
},
"device_info": null,
"name": null,
"cardholder": "CARDHOLDER NAME",
"image": null,
"paysys": "RBS"
},
"payment_methods": null,
"error": {
"user_message": "Счет подтвержден",
"error_description": "",
"error_code": 0
},
"invoice": {
"delivery_info": {
"delivery_type": null,
"address": {
"country": null,
"city": null,
"address": null
},
"description": null
},
"invoice_params": [
{
"key": "inapp_serviceparam_message_about_loyalty",
"value": "Оплатить подписку сейчас можно бонусами, а продлить её — только за рубли."
},
{
"key": "inapp_serviceparam_action_name",
"value": "Подключить подписку"
},
{
"key": "inapp_serviceparam_features",
"value": "VERIFY"
},
{
"key": "period_type",
"value": "DAY"
},
{
"key": "period_duration",
"value": "1"
},
{
"key": "current_period",
"value": "STANDARD"
},
{
"key": "payment_type",
"value": "INITIAL"
}
],
"purchaser": {
"email": null,
"phone": null,
"contact": null
},
"order": {
"order_id": "a090a93c-ca06-493d-a90a-ce2bac722358",
"order_number": "311",
"order_date": "2023-07-18T14:31:33+03",
"service_id": "4720",
"expiration_date": "2023-07-18T14:51:33+03",
"tax_system": null,
"trade_name": null,
"visual_name": "Покупка/Продление подписки",
"org_name": "ООО Супер ООО",
"org_inn": "4419198349",
"visual_amount": "1 ₽",
"order_bundle": [
{
"position_id": 1,
"item_params": [
{
"key": "_auto_itemAttributes_agent_info.type",
"value": "7"
},
{
"key": "_auto_itemAttributes_supplier_info.name",
"value": "ООО \"Нарана\""
},
{
"key": "_auto_itemAttributes_supplier_info.inn",
"value": "4419198349"
}
],
"item_amount": 100,
"item_code": "1day",
"item_price": 100,
"discount_type": null,
"discount_value": null,
"interest_type": null,
"interest_value": null,
"tax_type": 6,
"tax_sum": null,
"name": "Оплата за покупку подписки \"1day\". Провайдер: \"Покупка/Продление подписки\"",
"quantity": {
"value": 1,
"measure": "шт"
},
"currency": "RUB",
"image": ""
}
],
"amount": 100,
"currency": "RUB",
"purpose": "1day",
"description": "1day",
"language": "ru-RU"
}
},
"image": ""
},
"timestamp": "2023-08-02T10:11:04.655684723+03:00"
}
请求验证
在接收请求时,将检查通过获取授权令牌方法获得的授权令牌:
- 所有者和/ 或应用程序不应被封锁;
- 令牌应该是有效的;
- 应用程序代码 application_code 应该与获得授权令牌的所有者相对应。