» Home › Connector Developer's Guide › Connector Functions ›

pay_patron_fines()

» Submitted by jblyberg on Thu, 10/01/2009 - 9:39pm

Function:
pay_patron_fines ($cardnum, $pin = NULL, $payment_details)

Purpose:
pay_patron_fines() needs to accept an array of $payment_details and and pay off selected charges to a patron's account.

Arguments:
$cardnum : (string) required The patron's library card number.
$pin : (string) optional The patron's PIN number or password. (must explicitly pass NULL for no pin)
$payment_details : (array) required A standard array of unique identifiers of items whose holds are to be canceled.

Array ($payment_details)
(
    [varnames] => Array of variable references to specific charges
        (
            [{variable reference}] => (string) Variable value
        )
    [total] => (float) Total amount of charges to be paid
    [name] => (string) Name on the credit card used
    [address1] => (string) Billing address, line 1
    [address2] => (string) (optional) Billing address, line 2
    [city] => (string) Billing address city
    [state] => (string) Billing address state
    [zip] => (string) Billing address zip code
    [email] => (string) Patron's email address
    [ccnum] => Credit card number
    [ccexpmonth] => Credit card expiration month
    [ccexpyear] => Credit card expiration year
    [ccseccode] => Credit card security code
)

Expected Result:

Array
(
    [approved] => (int) 1 = Payment was successful, 0 = Payment was unsuccessful
    [error] => (string) Error message if payment could not be processed
    [reason] => (string) Error message if the credit card was declined
)