README

PHP CheckoutJS 集成文档

PHP CheckoutJS 集成

使用 Worldline 的 CheckoutJS 将您的 PHP 应用程序集成，以无缝处理支付。

徽章

目录

1. 安装
2. 配置
3. 使用
   • 基本使用
   • 高级功能
4. 示例
5. 测试
6. 贡献
7. 许可证

安装

通过 Composer 安装此包

composer require worldline-ind/php-checkoutjs

配置

将以下内容的 worldline_AdminData.json 文件放置在您的项目根目录中

{
"merchantCode": "YOUR_MERCHANT_CODE",
"merchantSchemeCode": "YOUR_SCHEME_CODE",
"salt": "YOUR_SALT",
"typeOfPayment": "TEST",
"currency": "INR",
"primaryColor": "#000000",
"secondaryColor": "#FFFFFF",
"buttonColor1": "#0000FF",
"buttonColor2": "#FFFFFF",
"logoURL": "https://yourdomain.com/logo.png",
"enableExpressPay": true,
"separateCardMode": false,
"enableNewWindowFlow": true,
"merchantMessage": "Thank you for your order!",
"disclaimerMessage": "Please review your order before proceeding.",
"paymentMode": "ALL",
"paymentModeOrder": "NB,CARD,UPI",
"enableInstrumentDeRegistration": false,
"transactionType": "SALE",
"hideSavedInstruments": false,
"saveInstrument": false,
"displayTransactionMessageOnPopup": false,
"embedPaymentGatewayOnPage": false,
"enableEmandate": false,
"hideSIConfirmation": false,
"expandSIDetails": false,
"enableDebitDay": false,
"showSIResponseMsg": false,
"showSIConfirmation": false,
"enableTxnForNonSICards": false,
"showAllModesWithSI": false,
"enableSIDetailsAtMerchantEnd": false
}

使用

基本使用

初始化 Checkout 类

<?php

require 'vendor/autoload.php';

use WorldlineInd\CheckoutJS\Checkout;

$checkout = new Checkout("YOUR_MERCHANT_CODE", "INR", "YOUR_SALT");

?>

处理支付请求

<?php

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $data = [
        'mrctCode' => $_POST['mrctCode'],
        'txn_id' => $_POST['txn_id'],
        'amount' => $_POST['amount'],
        'custID' => $_POST['custID'],
        'mobNo' => $_POST['mobNo'],
        'email' => $_POST['email'],
        'returnUrl' => $_POST['returnUrl'],
    ];
    
    $checkout->processPayment($data);
}

?>

处理支付响应

<?php

$response = $_POST;
$verified = $checkout->verifyResponse($response);

if ($verified) {
    if ($response['statusCode'] == '0300') {
        echo "Transaction Successful";
    } else {
        echo "Transaction Failed";
    }
} else {
    echo "Invalid response hash";
}

?>

高级功能

在文档中探索退款、对账和服务器间通信等附加功能。

<?php

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $transactionIdentifier = $_POST['transactionIdentifier'];
    $fromDate = $_POST['fromtransactionDate'];
    $toDate = $_POST['totransactionDate'];

    $reconciliationData = $checkout->reconcile($transactionIdentifier, $fromDate, $toDate);
    // Process reconciliation data
}

?>

测试

运行以下命令以执行测试

phpunit

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 获取更多详细信息。

许可证

此项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。