/ 
Net-WholesaleSystem-0.01
River stage zero No dependents
/ Net::WholesaleSystem

NAME

Net::WholesaleSystem - VentraIP Wholesale SSL API

VERSION

version 0.01

SYNOPSIS

use Net::WholesaleSystem;

my $WholesaleSystem = Net::WholesaleSystem->new(
    resellerID => $resellerID,
    apiKey     => $apiKey
);

# get balance
my $balance = $WholesaleSystem->balanceQuery or die $WholesaleSystem->errstr;
print $balance;

DESCRIPTION

VentraIP Wholesale SSL API

new

my $WholesaleSystem = Net::WholesaleSystem->new(
    resellerID => $resellerID,
    apiKey     => $apiKey
);

  • resellerID (required)

  • apiKey (required)

    resellerID & apiKey, provided by VentraIP Wholesale

  • is_ote

    if is_ote is set to 1, we use https://api-ote.wholesalesystem.com.au/?wsdl instead of https://api.wholesalesystem.com.au/?wsdl

  • debug

    enable SOAP::Trace->import('all')

balanceQuery

my $balance = $WholesaleSystem->balanceQuery or die $WholesaleSystem->errstr;

Account Balance Query allows you to obtain the account balance.

getSSLCertificate

my $cert = $WholesaleSystem->getSSLCertificate($certID);

to obtain information for a SSL certificate you?ve recently purchased

getCertSimpleStatus

my $cert = $WholesaleSystem->getCertSimpleStatus($certID);

decodeCSR

my $data = $WholesaleSystem->decodeCSR($csr);

decode the certificate signing request (CSR) you have provided to ensure all the details are correct before purchasing the SSL.

generateCSR

my $data = $WholesaleSystem->generateCSR(
    'numOfYears' => '3',
    'country' => 'AU',
    'state'   => 'VIC',
    'city'    => 'Melbourne',
    'organisation' => 'VentraIP',
    'organisationUnit' => 'Systems Admin',
    'commonName' => 'forums.ventraip.com.au',
    'emailAddress' => 'webmaster@ventraip.com.au'
);

generate the user a Private Key of 2048 bits in size, a Self Signed Certificate and a CSR request.

purchaseSSLCertificate

my $cert = $WholesaleSystem->purchaseSSLCertificate(
    csr => $csr,
    productID => 55,
    firstName => 'John',
    lastName  => 'Doe',
    emailAddress => 'john@doe.com',
    address => 'PO Box 119',
    city => 'Beaconsfield',
    state => 'VIC',
    postCode => '3807',
    country => 'AU',
    phone => '+61.390245343',
    fax => '+61.380806481',
) or die $WholesaleSystem->errstr;

purchase an SSL certificate

reissueCertificate

my $output = $WholesaleSystem->reissueCertificate($certID, $newCSR);

re-issue the SSL certificate using a new certificate signing request (CSR)

cancelSSLCertificate

my $output = $WholesaleSystem->cancelSSLCertificate($certID);

cancel an SSL certificate that has not been processed (eg. still pending approval).

renewSSLCertificate

my $output = $WholesaleSystem->renewSSLCertificate(
    certID => $certID,
    firstName => 'John',
    lastName  => 'Doe',
    emailAddress => 'john@doe.com',
    address => 'PO Box 119',
    city => 'Beaconsfield',
    state => 'VIC',
    postCode => '3807',
    country => 'AU',
    phone => '+61.390245343',
    fax => '+61.380806481',
) or die $WholesaleSystem->errstr;

renew an SSL certificate

resendDVEmail

my $output = $WholesaleSystem->resendDVEmail($certID);

resend the approval email for an SSL certificate

resendIssuedCertificateEmail

my $output = $WholesaleSystem->resendIssuedCertificateEmail($certID);

resend the original completed certificate email to the customer. This is helpful should your customer loose the details of their SSL and you need to provide the information again.

listAllCerts

my @certs = $WholesaleSystem->listAllCerts;

obtain a list of all SSL certificates related to your account

getDomainBeacon

my $output = $WholesaleSystem->getDomainBeacon($certID, $domain);

obtain a list of all SSL certificates related to your account

The domain beacon is used for verification of premium SSL certificates to prove ownership of the domain and ensure the requester has access to the domain in question. The domain beacon file must be saved as the filename returned from the API request and the 'beacon' saved in the file.

checkDomainBeacon

my $output = $WholesaleSystem->checkDomainBeacon($certID, $domain);

Upon requesting the domain beacon from 'SSL_getDomainBeacon' this function will then process the SSL for validation against the certificate ID supplied.

Certificate Product IDs

55 Trustwave Domain Validated SSL - 1 Year
56 Trustwave Domain Validated SSL - 2 Year
57 Trustwave Domain Validated SSL - 3 Year
58 Trustwave Premium SSL - 1 year
59 Trustwave Premium SSL - 2 year
60 Trustwave Premium SSL - 3 year
61 Trustwave Enterprise SSL - 1 Year
62 Trustwave Enterprise SSL - 2 Year
63 Trustwave Enterprise SSL - 3 Year
64 Trustwave Premium Wildcard SSL - 1 Year
65 Trustwave Premium Wildcard SSL - 2 Year
66 Trustwave Premium Wildcard SSL - 3 Year
67 Trustwave Premium EV SSL - 1 Year
68 Trustwave Premium EV SSL - 2 Year

AUTHOR

VentraIP Wholesale <customercare@ventraipwholesale.com.au>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by VentraIP Wholesale.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.