MPGS（万事达卡）：如何标记交易（如何创建标记）？

Question

我正在尝试使用 MPGS 创建令牌。

我正在遵循本指南：

https://sample-sub.domain.mastercard.com/api/documentation/integrationGuidelines/supportedFeatures/pickAdditionalFunctionality/tokenization/tokenization.html?locale=en_US#x_tokenConfiguration

在“令牌操作”>“令牌化”部分中，它说：

您可以使用此操作通过存储来创建或更新token 针对令牌的付款详细信息。 ...

我发布这篇文章是为了帮助像我一样对 MPGS 感到沮丧的人。我面临一系列问题，并且多次拔掉头发。所以这是我面临的问题以及如何解决它们（我遇到了问题#4）。

---

问题 #1： 凭据无效。

修复：确保您点击了正确的网址。

https://示例子域.mastercard.com/..

https://some.other-example.mastercard.com/..

https://百万其他可能性.mastercard.com/..

即使是文档指南链接也有这些相同的子域，因此请确保您访问的是正确的 URL，并确保您访问的是正确的文档链接。

---

问题 #2： 参数无效，或者服务器要求参数，尽管您已经提供了参数。

修复：如果使用 Postman，请确保将“Body”>“raw”中的参数设置为 JSON，如下所示：

{
    "sourceOfFunds": {
        "provided": {
            "card": {
                "expiry": {
                    "month": "05",
                    "year": "21"
                },
                "number": "5123456789012346"
            }
        },
        "type": "CARD"
    }
}

---

问题 #3：需要授权

修复：如果使用 Postman，请点击“授权”，将“类型”设置为 基本身份验证，将“用户名”设置为 商家。 YOUR_MERCHANT_ID，对于“密码”，将其设置为 YOUR_API_PASSWORD

---

问题 #4（卡在此处）： 值“9999999999999999”无效。不得提供卡片令牌

方法：PUT

网址：https://test-my.sample.gateway.mastercard.com/api/rest/version/46/merchant/MY_MERCHANT_ID/token/9999999999999999

授权：在“授权”选项卡中正确设置

身体>原始：

{
    "sourceOfFunds": {
        "provided": {
            "card": {
                "expiry": {
                    "month": "05",
                    "year": "21"
                },
                "number": "5123456789012346"
            }
        },
        "type": "CARD"
    }
}

回复：

{
    "error": {
        "cause": "INVALID_REQUEST",
        "explanation": "Value '9999999999999999' is invalid. Card token must not be supplied",
        "field": "tokenid",
        "validationType": "INVALID"
    },
    "result": "ERROR"
}

问：不确定如何将交易标记化..？！我被问题#4困住了。

Answer 1

好的，终于明白了。 MPGS 有两种创建/更新令牌的方法：

1. Tokenization where YOU provide the token（注意：PUT 方法）
2. Tokenization where MPGS generate the token for you（注意：POST 方法）

它们非常相似。

我可以使用第二个选项。

注意：这是POST方法！！

方法：POST

网址：https://SUBDOMAIN_YOU_SHOULD_BE_USING.mastercard.com/api/rest/version/50/merchant/YOUR_MERCHANT_ID/token

在邮递员中，设置授权（如问题中所述，在 issue #3 中）。

要发送的样本数据（在邮递员中，这应该在 Body > raw 中）：

{
    "sourceOfFunds": {
        "provided": {
            "card": {
                "expiry": {
                    "month": "05",
                    "year": "21"
                },
                "number": "5123456789012346"
            }
        },
        "type": "CARD"
    }
}

示例响应：

{
    "repositoryId": "1000000000002",
    "response": {
        "gatewayCode": "BASIC_VERIFICATION_SUCCESSFUL"
    },
    "result": "SUCCESS",
    "sourceOfFunds": {
        "provided": {
            "card": {
                "brand": "MASTERCARD",
                "expiry": "0521",
                "fundingMethod": "CREDIT",
                "issuer": "BANCO DEL PICHINCHA, C.A.",
                "number": "512345xxxxxx2346",
                "scheme": "MASTERCARD"
            }
        },
        "type": "CARD"
    },
    "status": "VALID",
    "token": "9717501974559694",
    "usage": {
        "lastUpdated": "2019-02-25T09:36:54.928Z",
        "lastUpdatedBy": "1015",
        "lastUsed": "2019-02-25T09:36:54.928Z"
    },
    "verificationStrategy": "BASIC"
}