NAME

WWW::LogicBoxes::Role::Command::Domain::Transfer - Domain Transfer Related Operations

SYNOPSIS

use WWW::LogicBoxes;
use WWW::LogicBoxes::DomainTransfer;
use WWW::LogicBoxes::DomainRequest::Transfer;

my $logic_boxes = WWW::LogicBoxes->new( ... );

# Check Transferability
if( $logic_boxes->is_domain_transferable( 'some-domain.com' ) ) {
    print "Domain is transferable';
}
else {
    print "Domain is not transferable";
}

# Transfer Domain
my $transfer_request = WWW::LogicBoxes::DomainRequest::Transfer->new( ... );
my $domain_transfer  = $logic_boxes->transfer_domain( $transfer_request );

# Deletion
$logic_boxes->delete_domain_transfer_by_id( $domain_transfer->id );

# Resend Transfer Approval Mail
$logic_boxes->resend_transfer_approval_mail_by_id( $domain_transfer->id );

REQUIRES

submit

get_domain_by_id

DESCRIPTION

Implemented domain transfer related operations with the LogicBoxes' API.

METHODS

is_domain_transferable

use WWW::LogicBoxes;

my $logic_boxes = WWW::LogicBoxes->new( ... );

if( $logic_boxes->is_domain_transferable( 'some-domain.com' ) ) {
    print "Domain is transferable';
}
else {
    print "Domain is not transferable";
}

Given a domain name, uses LogicBoxes to determine if this domain is transferable in it's current state.

NOTE LogicBoxes will accept transfer requests even if the domain is not actually eligble for transfer so you should call this method before making a domain transfer request.

transfer_domain

use WWW::LogicBoxes;
use WWW::LogicBoxes::DomainTransfer;
use WWW::LogicBoxes::DomainRequest::Transfer;

my $logic_boxes = WWW::LogicBoxes->new( ... );

my $transfer_request = WWW::LogicBoxes::DomainRequest::Transfer->new( ... );
my $domain_transfer  = $logic_boxes->transfer_domain( $transfer_request );

Given a WWW::LogicBoxes::DomainRequest::Transfer or a HashRef that can be coerced into a WWW::LogicBoxes::DomainRequest::Transfer, attempt to transfer the domain with LogicBoxes.

Returns a fully formed WWW::LogicBoxes::DomainTransfer.

delete_domain_transfer_by_id

use WWW::LogicBoxes;
use WWW::LogicBoxes::DomainTransfer;
use WWW::LogicBoxes::DomainRequest::Transfer;

my $logic_boxes = WWW::LogicBoxes->new( ... );

my $domain_transfer = $logic_boxes->get_domain_by_id( ... );
$logic_boxes->delete_domain_transfer_by_id( $domain_transfer->id );

Given an Integer representing an in progress transfer, deletes the specfied domain transfer. There is a limited amount of time in which you can do this for a new transfer, and you can only do it before the transfer is completed. If you do this too often then LogicBoxes will get grumpy with you.

resend_transfer_approval_mail_by_id

use WWW::LogicBoxes;
use WWW::LogicBoxes::DomainTransfer;
use WWW::LogicBoxes::DomainRequest::Transfer;

my $logic_boxes = WWW::LogicBoxes->new( ... );

my $domain_transfer = $logic_boxes->get_domain_by_id( ... );
$logic_boxes->resend_transfer_approval_mail_by_id( $domain_transfer->id );

Given an Integer representing an in progress transfer that has not yet been approved by the admin contact as specified by the losing registrar, will resend the transfer approval email. If this method is used on a completed transfer, a registration, or a domain that has already been approved this method will croak with an error.

submit_auth_code

use WWW::LogicBoxes;
use WWW::LogicBoxes::DomainTransfer;

my $logic_boxes = WWW::LogicBoxes->new( ... );
my $epp_value = somehow_get_code_from_current_registrar( ... );

my $domain_transfer = $logic_boxes->get_domain_by_id( ... );
$logic_boxes->submit_auth_code( { id => $domain_transfer->id, auth_code => $epp_value } );

Submits the Domain Secret (also known as Authorization Code, also known as EPP key) for an in-progress domain transfer. Successfull submission results in silent return, otherwise, croaks.