通过购买令牌获取支付数据

注意

该门户网站正在开发中。文档的完整版本请看这里.

此方法允许通过购买令牌获取支付信息。

交互参数

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	首选的通信方式	email

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://upload.wikimedia.org/wikipedia/commons/thumb/d/d6/Visa_2021.svg/1280px-Visa_2021.svg.png`
`image`	string	卡标志链接	`http://www.sberbank.ru/common/img/uploaded/craftmigrate/retail/page_1635249630987/images/50a5ed66-5854-43ae-b368-e65e93207771/1673605800000_16801_teaser_teaserimageurl.jpg`
`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://cdn-icons-png.flaticon.com/512/3473/3473861.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 应该与获得授权令牌的所有者相对应。

通过购买令牌获取支付数据

交互参数​

响应参数​

请求验证​

交互参数

响应参数

请求验证