close
    Docs / References / Checkout
    Contents

    Link parameters

    Checkout is configured by the parameters passed in the URL of a GET request. The key/value pairs of the query string are secured by passing a hashed string created from the query string, in addition to the query string itself.

    URL: https://web.na.bambora.com/scripts/payment/payment.asp

    Authorization

    Name Description
    merchant_id Your 9-digit Bambora merchant ID
    hashValue The value for hashValue is generated by appending a hash key to the transaction request query string and using a hash algorithm (either MD5 or SHA-1) on the resulting string. It is recommended to include as much data as possible in the hash

    Order info

    Name Description
    trnAmount The total amount for the transaction including tax and additional fees. Max 2 decimal places. Max 9 digits total.
    trnOrderNumber The invoice or order ID you want associated with the transaction. Up to 30 characters. Do not include spaces.
    trnType P - Purchase. PA - Pre-Authorization.
    trnCardOwner The name of the cardholder. 4-64 characters.
    trnLanguage eng - English, fre - French.

    Billing address

    Name Description
    ordName The billed contact's name. Up to 64 characters.
    ordEmailAddress The email address of the billed contact and destination for email receipts in a valid email format. Up to 64 characters.
    ordAddress1 The billing address for the card holder. With Address Verification, this will need to match the card issuer's records. Up to 32 characters.
    ordAddress2 The second line for the card holder's billing address. Up to 32 characters
    ordCity The city associated with the billing address. Up to 32 characters.
    ordProvince The province or state associated with the billing address. As a variable, the two-letter ISO code.
    ordPostalCode The postal or ZIP code associated with the billing address. Up to 16 characters.
    ordCountry The country associated with the billing address. As a variable, the two-letter ISO code.

    Shipping address

    Name Description
    shipName The name of the contact receiving the shipment. Up to 64 characters.
    shipEmailAddress The shipping contact's email address in a valid email format. Up to 64 characters.
    shipAddress1 The shipping contact's destination address. Up to 32 characters.
    shipAddress2 The second line of the shipping contact's destination address. Up to 32 characters
    shipCity The shipping contact's destination city. Up to 32 characters.
    shipProvince The shipping contact's province or state destination. As a variable, the two-letter ISO code. Provinces and States.
    shipPostalCode The shipping contact's postal or ZIP code. Up to 16 characters.
    shipCountry The shipping contact's destination country. As a variable, the two-letter ISO code.
    shipPhoneAddress The shipping contact's phone number. Up to 32 characters.

    Redirects

    Name Description
    approvedPage The URL the cardholder will be sent to after their transaction is approved.
    declinedPage The URL the cardholder will be sent to after their transaction is declined.

    Hash expiry

    Name Description
    hashExpiry The time when the hash secured link will expire. The format is YYYYMMDDHHMM on PST.

    References info

    Name Description
    ref1 A custom identifier. 256 characters.
    ref2 A custom identifier. 256 characters.
    ref3 A custom identifier. 256 characters.
    ref4 A custom identifier. 256 characters.
    ref5 A custom identifier. 256 characters.