申请资金出境退回

商户可通过该接口发起资金出境退回申请，用于上报已跨境订单的退款信息。默认接口限频150/s

请求参数	类型	描述
json	object	声明请求的JSON数据结构
out_return_no	string	商户出境退回单号
sub_mchid	string	二级商户号
out_order_id	string	商户出境单号
transaction_id	string	微信订单号
refund_id	string	微信退款单号
amount	integer	退回金额

异步纯链式

$instance->v3->fundsToOversea->return->returnOrders->postAsync([
  'json' => [
    'out_return_no'  => 'R20250220103930',
    'sub_mchid'      => '123456',
    'out_order_id'   => 'merchant_1123123',
    'transaction_id' => '420000000000000010',
    'refund_id'      => '5017752501201407033233368018',
    'amount'         => 100,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

异步声明式

$instance->chain('v3/funds-to-oversea/return/return-orders')->postAsync([
  'json' => [
    'out_return_no'  => 'R20250220103930',
    'sub_mchid'      => '123456',
    'out_order_id'   => 'merchant_1123123',
    'transaction_id' => '420000000000000010',
    'refund_id'      => '5017752501201407033233368018',
    'amount'         => 100,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

异步属性式

$instance['v3/funds-to-oversea/return/return-orders']->postAsync([
  'json' => [
    'out_return_no'  => 'R20250220103930',
    'sub_mchid'      => '123456',
    'out_order_id'   => 'merchant_1123123',
    'transaction_id' => '420000000000000010',
    'refund_id'      => '5017752501201407033233368018',
    'amount'         => 100,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

同步纯链式

$response = $instance->v3->fundsToOversea->return->returnOrders->post([
  'json' => [
    'out_return_no'  => 'R20250220103930',
    'sub_mchid'      => '123456',
    'out_order_id'   => 'merchant_1123123',
    'transaction_id' => '420000000000000010',
    'refund_id'      => '5017752501201407033233368018',
    'amount'         => 100,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

同步声明式

$response = $instance->chain('v3/funds-to-oversea/return/return-orders')->post([
  'json' => [
    'out_return_no'  => 'R20250220103930',
    'sub_mchid'      => '123456',
    'out_order_id'   => 'merchant_1123123',
    'transaction_id' => '420000000000000010',
    'refund_id'      => '5017752501201407033233368018',
    'amount'         => 100,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

同步属性式

$response = $instance['v3/funds-to-oversea/return/return-orders']->post([
  'json' => [
    'out_return_no'  => 'R20250220103930',
    'sub_mchid'      => '123456',
    'out_order_id'   => 'merchant_1123123',
    'transaction_id' => '420000000000000010',
    'refund_id'      => '5017752501201407033233368018',
    'amount'         => 100,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
out_return_no	string	商户出境退回单号
sub_mchid	string	二级商户号
return_id	string	微信出境退回单号
out_order_id	string	商户出境单号
transaction_id	string	微信订单号
refund_id	string	微信退款单号
amount	integer	退回金额
state	string	出境退回状态 PROCESSING | SUCCESS | FAILED 枚举值之一
create_time	string	创建时间
success_time	string	成功时间
fail_reason	string	失败原因

参阅 官方文档