- 集成指南
- 支持的功能（付款方式）
- 实施浏览器付款集成
- paysafecard 付款
paysafecard
paysafecard 是一种预付费电子付款方式，可在很多国家国家使用，提供多种语言。 付款人从销售网点或授权的在线密码商店购买 paysafecard 代金券。 paysafecard 代金券包含一个 16 位的 PIN。 或者，如果付款人有 mypaysafecard 账户，当被重定向到 paysafecard 网页时，他们可以选择登录到 mypaysafecard 账户来批准付款。
建议您在构建 paysafecard 集成前，先阅读浏览器付款集成指南。
先决条件
要通过 Mastercard Gateway 提供 paysafecard 付款方式，
- 您必须向您的浏览器付款服务提供商注册
- 您在 Mastercard Gateway 上的商家配置文件必须通过浏览器付款服务提供商使用您的账户的详细信息配置，以及
- 您必须有使用支持的货币之一的 paysafecard 账户或代金券，且该账户已向您在浏览器付款服务提供商处的商家账户注册。
Paysafecard 交易
PPRO 收单行支持来自下表中提到的国家/地区和相应货币的 paysafecard 交易。
| 国家/地区 | 货币 |
|---|---|
| 澳大利亚 (AUS) | AUD |
| 奥地利 (AUT) | EUR |
| 比利时 (BEL) | EUR |
| 保加利亚 (BGR) | EUR |
| 加拿大 (CAN) | CAD |
| 克罗地亚 (HRV) | EUR |
| 塞浦路斯 (CYP) | EUR |
| 捷克共和国 (CZE) | EUR |
| 丹麦 (DNK) | EUR |
| 芬兰 (FIN) | EUR |
| 法国 (FRA) | EUR |
| 德国 (DEU) | EUR |
| 格鲁吉亚 (GEO) | EUR |
| 直布罗陀 (GIB) | EUR |
| 希腊 (GRC) | EUR |
| 匈牙利 (HUN) | EUR |
| 爱尔兰 (IRL) | EUR |
| 意大利 (ITA) | EUR |
| 列支敦士登 (LIE) | EUR |
| 立陶宛 (LTU) | EUR |
| 卢森堡 (LUX) | EUR |
| 马耳他 (MLT) | EUR |
| 墨西哥 (MEX) | USD |
| 新西兰 (NLD) | EUR |
| 荷兰 (NOR) | NOK |
| 挪威 (NZL) | EUR |
| 秘鲁 (PER) | EUR |
| 波兰 (POL) | PLN |
| 葡萄牙 (PRT) | EUR |
| 罗马尼亚语 (ROU) | RON |
| 斯洛文尼亚 (SVN) | EUR |
| 斯洛伐克 (SVK) | EUR |
| 西班牙 (ESP) | EUR |
| 瑞士 (CHE) | CHF |
| 瑞典 (SWE) | SEK |
| 英国 (GBR) | GBP |
| 乌拉圭 (URY) | EUR |
paysafecard 集成
Hosted Checkout 集成让您可以通过 Mastercard Gateway 托管和显示的交互来从付款人处收集付款详细信息。
从 API 版本 70 开始，在 your payment service provider 为您启用并配置了 paysafecard 后，它会自动成为付款方式之一。
有关详细信息，请参阅通过 Hosted Checkout 集成进行浏览器付款。
Direct Payment 集成可让您在自己的结账页提供 paysafecard 付款方式。
通用字段
除浏览器付款请求中需要的标准字段外，您还需要在 Initiate Browser Payment 请求中提供以下通用字段：
sourceOfFunds.type-PAYSAFECARDbrowserPayment.operation-PAYcustomer.account.id-The ID, username, hash, or anything used to identify the consumer.sourceOfFunds.provided.paysafecard.countryCode- 与 paysafecard 浏览器付款相关的其他详细信息。sourceOfFunds.provided.paysafecard.accountEmail-The mypaysafecard account email identifies the mypaysafecard account that will be refunded.
首选语言
您可以通过在 Initiate Browser Payment 请求中提供 browserPayment.preferredLanguage 字段来设置 paysafecard 为向付款人显示的页面使用的首选语言。 不过，此语言只有在 paysafecard 支持时才能够使用。
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com"
},
"order": {
"amount": "142.22",
"currency": "PLN"
},
"sourceOfFunds": {
"type": "PAYSAFECARD",
"provided": {
"paysafecard": {
"countryCode": "POL"
}
}
}
}
如何解释交易结果
下表指定了在发起 paysafecard 付款后您可能遇到的可能出现的情景的交易响应代码。
| Initiate Browser Payment 响应 | 具体含义... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
使用响应中提供的 URL 重定向付款人。 |
| Retrieve Transaction/Retrieve Order 响应 | 具体含义... |
response.gatewayCode=APPROVEDresult=SUCCESS |
付款成功。 |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway 等待来自收单行的付款结果通知。 稍后重试 RETRIEVE_TRANSACTION 或接收来自 Mastercard Gateway 的通知。 |
response.gatewayCode=CANCELLEDresult=FAILURE |
付款人已取消此付款的交互。 为付款人提供尝试其他付款方式的选项。 |
response.gatewayCode=DECLINED 或 ACQUIRER_SYSTEM_ERRORresult=FAILURE |
付款被拒绝。 为付款人提供尝试其他付款方式的选项。 如果出现 ACQUIRER_SYSTEM_ERROR，您可能需要询问收单行付款失败的原因，也可以重试 RETRIEVE_TRANSACTION。 |
response.gatewayCode=TIMED_OUTresult=FAILURE |
请将此情况视为被拒付款。 Mastercard Gateway 将进行尝试以确保交易不成功或撤消交易。 |
退款
您可以通过分期付款方式或全额退还 paysafecard 付款。 确保您已在 Mastercard Gateway 以及浏览器付款服务提供商处的商家账户上完成了退款配置。
要为 paysafecard 付款退款，付款人必须有 mypaysafecard 账户。 如果付款人没有 paysafecard 账户，或者他们来自不提供 mypaysafecard 账户的国家/地区，并且仅支持通过 paysafecard 代金券付款，那么您必须通过其他付款方式向付款人退款，例如，卡。
测试您的集成
Mastercard Gateway 提供允许您测试您的 paysafecard 集成的浏览器付款模拟器。