发起提现 MED

使用此端点针对某笔提现发起 MED，通过 endToEnd 指定该笔提现。

与经由收单机构送达的交易 MED 不同，提现 MED 由您主动发起。若要查看已发起的提现 MED，请使用查询提现 MED 列表。

可用环境

生产环境

https://api.gateway.com.br/core

端点

• 方法：POST
• 端点：/med/withdrawal
• 认证方式：Bearer token

请求体

名称	类型	必填	说明	校验规则
endToEnd	string	是	被争议提现的 end-to-end 标识	长度须在 8 到 255 个字符之间
reasonStatus	string (enum) - SCAM, FRAUDULENT_ACCESS, OPERATIONAL_ERROR, OTHER	是	发起 MED 的原因	必须为有效的枚举值
message	string	否	描述该案件的说明	长度须在 2 到 255 个字符之间

请求示例

cURL

curl --request POST \
--url https://api.gateway.com.br/core/med/withdrawal \
--header 'Authorization: Bearer your-jwt-token' \
--header 'Content-Type: application/json' \
--data '{
    "endToEnd": "E12345678202603061249abcdef0123",
    "reasonStatus": "OPERATIONAL_ERROR",
    "message": "Saque enviado para a chave errada"
}'

JavaScript

const response = await fetch('https://api.gateway.com.br/core/med/withdrawal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-jwt-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    endToEnd: 'E12345678202603061249abcdef0123',
    reasonStatus: 'OPERATIONAL_ERROR',
    message: 'Saque enviado para a chave errada',
  })
});

成功响应

此端点返回 201 Created，且没有响应体。请使用查询提现 MED 列表跟进已发起的案件。

可能的错误

状态码	说明	处理方式
401	凭据无效	请检查您的凭据
403	无权限或未授权	请联系技术支持
422	数据无效或缺失	请检查数据格式
422	校验失败	请联系技术支持
500	内部错误	请联系技术支持