MG+ Failed Transactions Quick Guide
Breadcrumbs

手动修补

本系统可提供当下MG+系统内的失败交易资讯给代理。

代理必须依据不同的异常状态,修正自己系统内的交易纪录,并且将MG+系统内的该笔交易纪录标示为已修正。

导致失败交易的原因可能有数种,例如:

  • 代理API错误

  • 代理API到期

  • 其他网路或软体相关异常

失败交易队列包含了处理失败的投注交易资料(actionType:Rollback)以及获胜交易资料actionType:Credit)。

重要:即使投注或是获胜的交易资料在贵端已经完成处理,只要该笔资料出现在队列中,我们仍然有可能会重新传送;原因可能为在我端未即时收到回应,或是其他异常。

请根据交易资料在贵端是否已完成处理,采取对应措施:

 

投注 (actionType:Rollback)

获胜 (actionType:Credit)

资料已处理

需将原始投注金额退款

无须采取任何措施

资料未处理

无须采取任何措施

需完成赔付

如遇到获胜的情况,该玩家将无法继续游玩游戏,直到该笔交易从队列中被清除。

在任何情况下,您需要针对该笔交易的 txnID 呼叫PATCH /failedTransactions,以将交易由队列中清除 。

只有具有 txnEventType 为 TOURNAMENT、PROMOTION、ACHIEVEMENT 或 STORE 的交易事件类型会在创建后的 7 天内返回。如果这些特定交易在 7 天后仍然未解决,将被标记为永久失败并从列中移除。在七天期限过后尝试修复此类交易将导致"404 找不到"错误。

对于其他交易事件类型,它们将保持在失败的交易列中,并可以使用该方法对其进行修复以标记为已解决。如果在列中找不到交易,也将返回“404 找不到”错误。


要实现此方法,您必须设置一个服务,用于定期获取失败交易并修补这些交易。 该服务需要每3到5分钟运行一次,不能超过此频率。

未能在允许的时间内修补交易可能导致游戏数据不完整。

请参考下图以获取创建此服务的指导。

AutomationforFailedTransactions.drawio-8ace4d832f0d7bf9e17a04ecf4c2ac2a6d89f786.png

失败交易相关的回应代码

回应代码

讯息

在下注失败的情况下的交易失败

在派彩失败的情况下的交易失败

4XX

Any 4XX error

No

Yes

500

Internal Server Error

Yes

Yes

501

Not Implemented

No

Yes

502

Bad Gateway

No

Yes

503

Service Unavailable

No

Yes

504

Gateway Timeout

Yes

Yes

505

HTTP Version Not Supported

No

Yes

506

Variant Also Negotiates

No

Yes

507

Insufficient Storage

No

Yes

508

Loop Detected

No

Yes

510

Not Extended

No

Yes

511

Network Authentication Required

No

Yes