Laravel中从Authorize.net交易获取银行卡末四位数字的教程

// app/Services/AuthorizeNetService.php (示例服务类)
use net\authorize\api\contract\v1 as AnetAPI;
use net\authorize\api\controller as AnetController;

class AuthorizeNetService
{
    protected $merchantAuthentication;

    public function __construct()
    {
        $this->merchantAuthentication = new AnetAPI\MerchantAuthenticationType();
        $this->merchantAuthentication->setName(env('MERCHANT_LOGIN_ID'));
        $this->merchantAuthentication->setTransactionKey(env('MERCHANT_TRANSACTION_KEY'));
    }

    // ... 其他方法
}

MERCHANT_LOGIN_ID=your_authorize_net_login_id
MERCHANT_TRANSACTION_KEY=your_authorize_net_transaction_key

public function getTransactionDetails(string $transactionId)
{
    // 设置商家认证信息
    $merchantAuthentication = new AnetAPI\MerchantAuthenticationType();
    $merchantAuthentication->setName(env('MERCHANT_LOGIN_ID'));
    $merchantAuthentication->setTransactionKey(env('MERCHANT_TRANSACTION_KEY'));

    // 创建交易详情请求
    $request = new AnetAPI\GetTransactionDetailsRequest();
    $request->setMerchantAuthentication($merchantAuthentication);
    $request->setTransId($transactionId); // 设置要查询的交易ID

    // ...
}

public function getTransactionDetails(string $transactionId)
{
    // ... (上述认证和请求构建代码)

    // 创建并执行控制器
    $controller = new AnetController\GetTransactionDetailsController($request);
    $response = $controller->executeWithApiResponse(
        \net\authorize\api\constants\ANetEnvironment::SANDBOX // 根据实际情况选择 SANDBOX 或 PRODUCTION
    );

    return $response;
}

// 假设 $response 是从 Authorize.net API 返回的响应对象
$transactionDetails = $response->getTransaction();

if ($transactionDetails !== null) {
    // 成功获取到交易详情对象
    // 现在可以进一步处理 $transactionDetails
} else {
    // 交易详情为空，可能需要检查API响应中的错误信息
    // 例如：$response->getMessages()->getMessage()
}

if ($transactionDetails !== null) {
    $payment = $transactionDetails->getPayment(); // 获取支付信息

    if ($payment !== null) {
        $creditCard = $payment->getCreditCard(); // 获取信用卡信息 (PaymentMaskedType内部的CreditCardMaskedType)

        if ($creditCard !== null) {
            $cardNumber = $creditCard->getCardNumber(); // 获取掩码后的卡号，例如 "XXXX1234"
            // $expirationDate = $creditCard->getExpirationDate(); // 也可以获取过期日期

            echo "银行卡末四位: " . substr($cardNumber, -4); // 进一步提取末四位
        } else {
            echo "未找到信用卡信息，可能支付方式不是信用卡。";
        }
    } else {
        echo "未找到支付信息。";
    }
} else {
    echo "无法获取交易详情。";
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use net\authorize\api\contract\v1 as AnetAPI;
use net\authorize\api\controller as AnetController;
use Exception;

class AuthorizeNetController extends Controller
{
    /**
     * 获取指定交易的银行卡末四位数字。
     *
     * @param string $transactionId 交易ID
     * @return \Illuminate\Http\JsonResponse
     */
    public function getCardLastFourDigits(string $transactionId)
    {
        try {
            // 1. 设置商家认证信息
            $merchantAuthentication = new AnetAPI\MerchantAuthenticationType();
            $merchantAuthentication->setName(env('MERCHANT_LOGIN_ID'));
            $merchantAuthentication->setTransactionKey(env('MERCHANT_TRANSACTION_KEY'));

            // 2. 创建交易详情请求
            $request = new AnetAPI\GetTransactionDetailsRequest();
            $request->setMerchantAuthentication($merchantAuthentication);
            $request->setTransId($transactionId);

            // 3. 创建并执行控制器
            $controller = new AnetController\GetTransactionDetailsController($request);
            $response = $controller->executeWithApiResponse(
                \net\authorize\api\constants\ANetEnvironment::SANDBOX // 根据实际环境选择 SANDBOX 或 PRODUCTION
            );

            // 4. 处理API响应
            if ($response !== null) {
                if ($response->getMessages()->getResultCode() == "Ok") {
                    $transactionDetails = $response->getTransaction();

                    if ($transactionDetails !== null) {
                        $payment = $transactionDetails->getPayment();

                        if ($payment !== null && $payment->getCreditCard() !== null) {
                            $creditCard = $payment->getCreditCard();
                            $cardNumberMasked = $creditCard->getCardNumber(); // 例如 "XXXX1234"
                            $lastFourDigits = substr($cardNumberMasked, -4);

                            return response()->json([
                                'success' => true,
                                'transaction_id' => $transactionId,
                                'card_last_four_digits' => $lastFourDigits,
                                'card_type' => $creditCard->getCardType() // 也可以获取卡类型
                            ]);
                        } else {
                            return response()->json([
                                'success' => false,
                                'message' => '未找到信用卡支付信息或支付方式不是信用卡。'
                            ], 404);
                        }
                    } else {
                        return response()->json([
                            'success' => false,
                            'message' => '未能获取交易详情。'
                        ], 404);
                    }
                } else {
                    $messages = $response->getMessages()->getMessage();
                    $errorMessage = "Authorize.net API错误: " . $messages[0]->getCode() . " - " . $messages[0]->getText();
                    return response()->json([
                        'success' => false,
                        'message' => $errorMessage
                    ], 500);
                }
            } else {
                return response()->json([
                    'success' => false,
                    'message' => 'Authorize.net API响应为空。'
                ], 500);
            }
        } catch (Exception $e) {
            return response()->json([
                'success' => false,
                'message' => '发生异常: ' . $e->getMessage()
            ], 500);
        }
    }
}