模拟并撤销交易

交易 是指进行支付的过程。我们可以使用 Marqeta 支付卡来完成支付。授权交易 请求包含用户提供的授权信息，并生成一个电子消息，其中包含用于支付处理的信息。

在本课程中，我们将学习如何模拟一次授权交易及其撤销操作。

模拟授权交易

我们可以通过向 {BASE_URL}/simulate/authorization 端点发送 POST 请求来模拟授权交易。该端点需要携带 card_token 和其他授权详情。

注意： 此端点仅在沙箱环境（测试环境）中可用，不适用于生产环境。其目的是让我们能够测试在沙箱中创建的卡片、用户及其他对象。

请求参数

上述端点使用以下参数：

注意： 有关 card_acceptor、card_options、transaction_options、network_fees 和 webhook 对象的详细信息，请参阅课程附录中的“附加参数和响应字段”部分。

点击下方代码框中的“运行”按钮以查看输出结果。

1// 导入库
2import fetch from "node-fetch"
3
4// 定义端点 URL
5const endpointUrl = new URL('{{BASE_URL}}simulate/authorization');
6
7const tokens = '{{APPLICATION_TOKEN}}:{{ADMIN_ACCESS_TOKEN}}'
8const encoded = Buffer.from(tokens, 'ascii').toString('base64')
9
10const headerParameters = {
11    'Content-Type': 'application/json',
12    'Authorization': `Basic ${encoded}`
13};
14
15// 定义请求体参数
16const bodyParameters = JSON.stringify({
17    "amount": "100", 
18    "mid": "123456789",
19    "card_token": "{{CARD_TOKEN}}"
20});
21
22// 设置 API 调用选项
23const options = {
24    method: "POST",
25    headers: headerParameters,
26    body: bodyParameters
27};
28
29// 发起 API 调用的函数
30async function createCardProduct() {
31    try {
32        const response = await fetch(endpointUrl, options);
33        // 输出响应
34        printResponse(response);
35    } catch (error) {
36        // 输出错误信息
37        printError(error);
38    }
39}
40
41// 调用函数发起 API 调用
42createCardProduct();

在上述代码中：

• 第 5 行： 将端点 URL 存储在 endpointUrl 变量中。
• 第 16–20 行： 在 bodyParameters 变量中添加 amount、mid 和 card_token。由于我们仅在测试环境中模拟交易，因此为 mid 属性设置了任意数值 123456789。
• 第 24 行： 将请求方法设置为 POST，用于创建新的交易。
• 第 32 行： 使用 fetch 函数发起 API 调用。

响应字段

当代码成功执行后，输出将显示包含所有请求数据字段的完整交易对象。我们还会提取 token 和 amount 值，并分别存储为 TRANSACTION_TOKEN 和 TRANSACTION_AMOUNT。若出现失败，则会显示相应的错误信息。

一些重要的响应字段如下：

模拟交易撤销

我们可以通过向 {BASE_URL}/simulate/reversal 端点发送 POST 请求来模拟授权交易的撤销。该端点需要提供 original_transaction_token 和 amount 的值。交易撤销会将资金退还至最初扣款的账户，这通常发生在授权交易所冻结的资金被释放时。

请求参数

上述端点使用以下参数：

注意： 有关 network_fees 和 webhook 对象的详细信息，请参阅课程附录中的“附加参数和响应字段”部分。

点击下方代码框中的“运行”按钮以查看输出结果。

1// 导入库
2import fetch from "node-fetch"
3
4// 定义端点 URL
5const endpointUrl = new URL('{{BASE_URL}}simulate/reversal');
6
7const tokens = '{{APPLICATION_TOKEN}}:{{ADMIN_ACCESS_TOKEN}}'
8const encoded = Buffer.from(tokens, 'ascii').toString('base64')
9
10const headerParameters = {
11    'Content-Type': 'application/json',
12    'Authorization': `Basic ${encoded}`
13};
14
15// 定义请求体参数
16const bodyParameters = JSON.stringify({
17    "original_transaction_token": "{{TRANSACTION_TOKEN}}",
18    "amount": "{{TRANSACTION_AMOUNT}}"
19});
20
21// 设置 API 调用选项
22const options = {
23    method: "POST",
24    headers: headerParameters,
25    body: bodyParameters
26};
27
28// 发起 API 调用的函数
29async function createCardProduct() {
30    try {
31        const response = await fetch(endpointUrl, options);
32        // 输出响应
33        printResponse(response);
34    } catch (error) {
35        // 输出错误信息
36        printError(error);
37    }
38}
39
40// 调用函数发起 API 调用
41createCardProduct();

在上述代码中：

• 第 5 行： 将端点 URL 存储在 endpointUrl 变量中。
• 第 16–19 行： 在 bodyParameters 变量中提供 original_transaction_token 和 amount。
• 第 23 行： 将请求方法设置为 POST，用于创建新的撤销交易。
• 第 31 行： 使用 fetch 函数发起 API 调用。

响应字段

当代码成功执行后，输出将显示包含所有请求数据字段的完整交易对象。若出现失败，则会显示相应的错误信息。

请参考模拟交易的响应字段表，了解本次 API 调用的响应字段信息。