本系统可提供当下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分钟运行一次,不能超过此频率。
未能在允许的时间内修补交易可能导致游戏数据不完整。
请参考下图以获取创建此服务的指导。
失败交易相关的回应代码
|
回应代码 |
讯息 |
在下注失败的情况下的交易失败 |
在派彩失败的情况下的交易失败 |
|---|---|---|---|
|
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 |