Authorize.Net PHP SDK

The PHP SDK no longer supports several legacy classes (e.g., AuthorizeNetAIM.php, AuthorizeNetSIM.php). To ensure compatibility and access modern features, you must migrate your code to use the new Authorize.Net API classes.

Use the following mapping to identify the replacement feature for your legacy class:

For a detailed upgrade guide, visit the official Authorize.Net API Upgrade Guide.

To manage subscriptions via the Automated Recurring Billing (ARB) API, you must first instantiate an AuthorizeNet_Subscription object and populate its properties. Once the subscription object is configured, use an AuthorizeNetARB instance to submit the request.

Creating a Subscription

1. Create an AuthorizeNet_Subscription object.
2. Set properties such as name, intervalLength, intervalUnit, startDate, totalOccurrences, amount, and payment details (creditCardCardNumber, creditCardExpirationDate, creditCardCardCode).
3. Call $request->createSubscription($subscription) on an AuthorizeNetARB instance.

Updating a Subscription

To update an existing subscription, call $request->updateSubscription($subscription_id, $subscription) on an AuthorizeNetARB instance, passing the unique subscription ID and the updated AuthorizeNet_Subscription object.

$subscription = new AuthorizeNet_Subscription;
$subscription->name = "Short subscription";
$subscription->intervalLength = "1";
$subscription->intervalUnit = "months";
$subscription->startDate = "2011-03-12";
$subscription->totalOccurrences = "14";
$subscription->amount = rand(1,100);
$subscription->creditCardCardNumber = "6011000000000012";
$subscription->creditCardExpirationDate = "2018-10";
$subscription->creditCardCardCode = "123";
$subscription->billToFirstName = "john";
$subscription->billToLastName = "doe";

$request = new AuthorizeNetARB;
$response = $request->createSubscription($subscription);

// Or to update:
// $response = $request->updateSubscription($subscription_id, $subscription);

Transactions are created using the createCustomerProfileTransaction method on an AuthorizeNetCIM instance. You must specify the transaction type (e.g., "AuthCapture" or "Void") and an AuthorizeNetTransaction object.

An AuthorizeNetTransaction can include:

• amount: The transaction amount.
• customerProfileId: The ID of the customer.
• customerPaymentProfileId: The ID of the payment method.
• customerShippingAddressId: The ID of the shipping address.
• lineItems: An array of AuthorizeNetLineItem objects.

To void a transaction, use the type "Void" and provide the transId in the transaction object.

// Create Auth & Capture Transaction
$transaction = new AuthorizeNetTransaction;
$transaction->amount = "9.79";
$transaction->customerProfileId = $customerProfileId;
$transaction->customerPaymentProfileId = $paymentProfileId;
$transaction->customerShippingAddressId = $customerAddressId;
    
$lineItem = new AuthorizeNetLineItem;
$lineItem->itemId = "4";
$lineItem->name = "Cookies";
$lineItem->quantity = "4";
$lineItem->unitPrice = "1.00";
$lineItem->taxable = "true";

$transaction->lineItems[] = $lineItem;
    
$response = $request->createCustomerProfileTransaction("AuthCapture", $transaction);
$transactionResponse = $response->getTransactionResponse();
$transactionId = $transactionResponse->transaction_id;

// Voiding a Transaction
$voidTransaction = new AuthorizeNetTransaction;
$voidTransaction->transId = $transactionId;
$response = $request->createCustomerProfileTransaction("Void", $voidTransaction);

The Server Integration Method (SIM) allows you to offload the payment experience to Authorize.Net. The AuthorizeNetSIM_Form class helps automate the creation of the hidden form fields required to securely initiate a transaction.

To create a 'Buy Now' button that redirects users to a hosted order page, you must generate a fingerprint using getFingerprint and then instantiate AuthorizeNetSIM_Form with the required transaction parameters. This ensures the request is authenticated and tied to a specific amount and sequence.

<form method="post" action="https://test.authorize.net/gateway/transact.dll">
<?php
$amount = "9.99";
$fp_sequence = "123";
$time = time();

$fingerprint = AuthorizeNetSIM_Form::getFingerprint($api_login_id, $transaction_key, $amount, $fp_sequence, $time);
$sim = new AuthorizeNetSIM_Form(
    array(
    'x_amount'        => $amount,
    'x_fp_sequence'   => $fp_sequence,
    'x_fp_hash'       => $fingerprint,
    'x_fp_timestamp'  => $time,
    'x_relay_response'=> "FALSE",
    'x_login'         => $api_login_id,
    )
);
echo $sim->getHiddenFieldString();?>
<input type="submit" value="Buy Now">
</form>