申请代付

创建代付

POST/api/v1/payment/createOrder

提交代付订单，将资金转至收款账户。 此接口无需鉴权。

SDK 方法create()

参数请求体

orderTypestringrequired

代付类型，见[代付类型参考](/docs/reference/payout-type)。

memberidstringrequired

平台分配的商户号。

out_trade_nostringrequired

SDK 属性: outTradeNo. 商户代付订单号。

amountstringrequired

订单提交金额。

currencystringrequired

支付币种。

notifyurlstringrequired

代付完成 Webhook URL。

remarkstringrequired

代付备注，不能为空。

signstringrequiredsign

[MD5 签名算法说明](/docs/start#generate-signature)

firstnamestringrequired

收款人名。

payeeCountrystringrequired

收款国家（ISO 3166-1 alpha-2）。

payeeaccountstringrequired

银行卡或钱包账号。

bankcodestringrequired

本地银行编码。

banknamestringrequired

银行名称（VN 国家填 Short code）。

lastnamestring

收款人姓，为空时不参与签名。

响应

**200**：`ApiV1PaymentCreateOrderResponse` 通过 `getResult()` 返回。

POST/api/v1/payment/createOrder

use JPayApiLib\Models\Requests\Builders\CreatePayoutRequestBuilder;

$request = CreatePayoutRequestBuilder::init()
    ->orderType('BANK')
    ->memberid('10153')
    ->outTradeNo('PAYOUT20260101001')
    ->amount('100.00')
    ->currency('USD')
    ->notifyurl('https://yourdomain.com/payout/notify')
    ->remark('Salary payout')
    ->firstname('John')
    ->payeeCountry('VN')
    ->payeeaccount('1234567890')
    ->bankcode('970448')
    ->bankname('OCB')
    ->lastname('Doe')
    ->build();

$apiResponse = $client->getPayoutsApi()->create($request);

if ($apiResponse->isSuccess()) {
    /** @var \JPayApiLib\Models\ApiV1PaymentCreateOrderResponse $result */
    $result = $apiResponse->getResult();
    var_dump($result);
}