卡支付

卡支付

POST/pay_index

通过 `POST /pay_index` 发起卡支付。 卡支付通过 `create()` 发起。返回 `PaymentResponse`：

SDK 方法create()

参数请求体

pay_memberidstringrequired

SDK 属性: payMemberid. 平台分配的商户号。

pay_orderidstringrequired

SDK 属性: payOrderid. 商户订单号。

pay_applydatestringrequired

SDK 属性: payApplydate. 订单提交时间。

pay_bankcodestringrequired

SDK 属性: payBankcode. 支付方式银行编码。

pay_notifyurlstringrequired

SDK 属性: payNotifyurl. 服务器端支付通知的 Webhook URL（POST）。

pay_callbackurlstringrequired

SDK 属性: payCallbackurl. 客户付款后重定向 URL（GET）。

pay_amountstringrequired

SDK 属性: payAmount. 交易金额。

pay_md5signstringrequiredsign

SDK 属性: payMd5Sign. [MD5 签名算法说明](/docs/start#generate-signature)

pay_currencystringrequired

SDK 属性: payCurrency. ISO 4217 货币代码（如 `USD`）。

pay_urlstringrequired

SDK 属性: payUrl. 商户网站 URL。

pay_methodstringrequired

SDK 属性: payMethod. 支付方式名称，见[支付方式参考](/docs/reference/payment-method)。

pay_cardnostringrequired

SDK 属性: payCardno. 卡号（PAN）。

pay_cardmonthstringrequired

SDK 属性: payCardmonth. 卡片到期月份（如 `12`）。

pay_cardyearstringrequired

SDK 属性: payCardyear. 卡片到期年份（如 `2027`）。

pay_cardcvvstringrequired

SDK 属性: payCardcvv. CVV。

pay_firstnamestringrequired

SDK 属性: payFirstname. 持卡人名字。

pay_lastnamestringrequired

SDK 属性: payLastname. 持卡人姓氏。

pay_country_iso_code_2stringrequired

SDK 属性: payCountryIsoCode2. 账单国家（ISO 3166-1 alpha-2）。

pay_email_addressstringrequired

SDK 属性: payEmailAddress. 账单邮箱。

pay_telephonestringrequired

SDK 属性: payTelephone. 账单电话。

pay_ipstringrequired

SDK 属性: payIp. 客户 IP 地址。

pay_useragentstringrequired

SDK 属性: payUseragent. 浏览器 User-Agent。

pay_typestring

SDK 属性: payType. 账单类型（卡支付不使用 `apm`）。

pay_street_address1string

SDK 属性: payStreetAddress1. 账单地址第 1 行。

pay_street_address2string

SDK 属性: payStreetAddress2. 账单地址第 2 行。

pay_citystring

SDK 属性: payCity. 账单城市。

pay_postcodestring

SDK 属性: payPostcode. 账单邮政编码。

pay_statestring

SDK 属性: payState. 账单州/省。

pay_languagestring

SDK 属性: payLanguage. 首选语言。

systemstring

电商平台名称。

响应

**200**：成功响应 — 通过 `getResult()` 获取 `PaymentResponse`。

POST/pay_index

use JPayApiLib\Models\Requests\Builders\PaymentRequestBuilder;

$request = PaymentRequestBuilder::init()
        ->payMemberid('10153')
        ->payOrderid('O' . time())
        ->payNotifyurl('https://yourdomain.com/notify')
        ->payCallbackurl('https://yourdomain.com/callback')
        ->payAmount('100.00')
        ->payCurrency('USD')
        ->payUrl('https://yourdomain.com')
        ->payFirstname('John')
        ->payLastname('Doe')
        ->payCountryIsoCode2('US')
        ->payEmailAddress('[email protected]')
        ->payTelephone('1234567890')
        ->build();

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

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

    switch ($result->getStatus()) {
        case 0:
            echo 'Payment succeeded: ' . $result->getMsg();
            break;
        case 1:
            // Redirect customer to 3DS page
            header('Location: ' . $result->getUrl());
            break;
        default:
            echo 'Payment failed: ' . $result->getMsg();
    }
}