A integração “Moip Transparente” permitirá que você disponibilize as opções de pagamento “Cartão de crédito”, “Boleto Bancário” e “Debito em conta” sem que o cliente necessite sair de seu ambiente.

E o melhor de tudo, você poderá utilizar sua integração atual com a API Moip, sendo necessário apenas importar o JavaScript da ferramenta e realizando as chamadas em camada de apresentação.

Referência API

Exemplo: Instrução Simples

Frete próprio

<?php ob_start();
$token = "SEU TOKEN";
$key = "SUA KEY";

$base = $token . ":" . $key;
$auth = base64_encode($base);
$header[] = "Authorization: Basic " . $auth;
$param = "
<EnviarInstrucao>
    <InstrucaoUnica>
        <Razao>Pagamento direto com boleto</Razao>
        <IdProprio>". rand(1,1000) ."</IdProprio>
        <Pagador>
            <Nome>Luiz Inácio Lula da Silva</Nome>
            <Email>presidente@planalto.gov.br</Email>
            <TelefoneCelular>(61)9999-9999</TelefoneCelular>
            <Apelido>Lula</Apelido>
            <Identidade>111.111.111-11</Identidade>
            <EnderecoCobranca>
                <Logradouro>Praça dos Três Poderes</Logradouro>
                <Numero>0</Numero>
                <Complemento>Palácio do Planalto</Complemento>
                <Bairro>Zona Cívico-Administrativa</Bairro>
                <Cidade>Brasília</Cidade>
                <Estado>DF</Estado>
                <Pais>BRA</Pais>
                <CEP>70100-000</CEP>
                <TelefoneFixo>(61)3211-1221</TelefoneFixo>
            </EnderecoCobranca>
        </Pagador>
        <Entrega>
            <Destino>MesmoCobranca</Destino>
            <CalculoFrete>
                <Tipo>Proprio</Tipo>
                <ValorFixo>2.30</ValorFixo>
                <Prazo Tipo=\"Corridos\">3</Prazo>
            </CalculoFrete>
        </Entrega>
        <PagamentoDireto>
            <Forma>BoletoBancario</Forma>
        </PagamentoDireto>
        <Boleto>
            <DiasExpiracao Tipo=\"Corridos\">5</DiasExpiracao>
        </Boleto>
        <Valores>
            <Valor moeda=\"BRL\">100.00</Valor>
        </Valores>
    </InstrucaoUnica>
</EnviarInstrucao>";

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://desenvolvedor.moip.com.br/sandbox/ws/alpha/EnviarInstrucao/Unica");
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_USERPWD, $user . ":" . $passwd);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_USERAGENT, "Mozilla/4.0");
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $param);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$ret = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
$xml = new SimpleXMLElement($ret);
echo "<pre>";
print_r($xml);
$token = $xml->Resposta->Token[0];
$url = 'https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token='.$token;
echo $url;

Correios com encomenda normal

<?php ob_start();
$token = "SEU TOKEN";
$key = "SUA KEY";

$base = $token . ":" . $key;
$auth = base64_encode($base);
$header[] = "Authorization: Basic " . $auth;
$param = "
<EnviarInstrucao>
    <InstrucaoUnica>
        <Razao>Pagamento direto com boleto</Razao>
        <IdProprio>". rand(1,1000) ."</IdProprio>
        <Pagador>
            <Nome>Luiz Inácio Lula da Silva</Nome>
            <Email>presidente@planalto.gov.br</Email>
            <TelefoneCelular>(61)9999-9999</TelefoneCelular>
            <Apelido>Lula</Apelido>
            <Identidade>111.111.111-11</Identidade>
            <EnderecoCobranca>
                <Logradouro>Praça dos Três Poderes</Logradouro>
                <Numero>0</Numero>
                <Complemento>Palácio do Planalto</Complemento>
                <Bairro>Zona Cívico-Administrativa</Bairro>
                <Cidade>Brasília</Cidade>
                <Estado>DF</Estado>
                <Pais>BRA</Pais>
                <CEP>70100-000</CEP>
                <TelefoneFixo>(61)3211-1221</TelefoneFixo>
            </EnderecoCobranca>
        </Pagador>
        <Entrega>
            <Destino>MesmoCobranca</Destino>
            <CalculoFrete>
                <Tipo>Correios</Tipo>
                <Prazo Tipo=\"Corridos\">3</Prazo>
                <Correios>
                    <PesoTotal>1.00</PesoTotal>
                    <FormaEntrega>EncomendaNormal</FormaEntrega>
                </Correios>
            </CalculoFrete>
        </Entrega>
        <PagamentoDireto>
            <Forma>BoletoBancario</Forma>
        </PagamentoDireto>
        <Boleto>
            <DiasExpiracao Tipo=\"Corridos\">5</DiasExpiracao>
        </Boleto>
        <Valores>
            <Valor moeda=\"BRL\">100.00</Valor>
        </Valores>
    </InstrucaoUnica>
</EnviarInstrucao>";

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://desenvolvedor.moip.com.br/sandbox/ws/alpha/EnviarInstrucao/Unica");
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_USERPWD, $user . ":" . $passwd);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_USERAGENT, "Mozilla/4.0");
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $param);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$ret = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
$xml = new SimpleXMLElement($ret);
echo "<pre>";
print_r($xml);
$token = $xml->Resposta->Token[0];
$url = 'https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token='.$token;
echo $url;

Correios com Sedex 10

<?php ob_start();
$token = "SUA TOKEN";
$key = "SUA KEY";

$base = $token . ":" . $key;
$auth = base64_encode($base);
$header[] = "Authorization: Basic " . $auth;
$param = "
<EnviarInstrucao>
    <InstrucaoUnica>
        <Razao>Pagamento direto com boleto</Razao>
        <IdProprio>". rand(1,1000) ."</IdProprio>
        <Pagador>
            <Nome>Luiz Inácio Lula da Silva</Nome>
            <Email>presidente@planalto.gov.br</Email>
            <TelefoneCelular>(61)9999-9999</TelefoneCelular>
            <Apelido>Lula</Apelido>
            <Identidade>111.111.111-11</Identidade>
            <EnderecoCobranca>
                <Logradouro>Praça dos Três Poderes</Logradouro>
                <Numero>0</Numero>
                <Complemento>Palácio do Planalto</Complemento>
                <Bairro>Zona Cívico-Administrativa</Bairro>
                <Cidade>Brasília</Cidade>
                <Estado>DF</Estado>
                <Pais>BRA</Pais>
                <CEP>70100-000</CEP>
                <TelefoneFixo>(61)3211-1221</TelefoneFixo>
            </EnderecoCobranca>
        </Pagador>
        <Entrega>
            <Destino>MesmoCobranca</Destino>
            <CalculoFrete>
                <Tipo>Correios</Tipo>
                <Prazo Tipo=\"Corridos\">5</Prazo>
                <Correios>
                    <PesoTotal>1.12</PesoTotal>
                    <FormaEntrega>Sedex10</FormaEntrega>
                </Correios>
            </CalculoFrete>
        </Entrega>
        <PagamentoDireto>
            <Forma>BoletoBancario</Forma>
        </PagamentoDireto>
        <Boleto>
            <DiasExpiracao Tipo=\"Corridos\">5</DiasExpiracao>
        </Boleto>
        <Valores>
            <Valor moeda=\"BRL\">100.00</Valor>
        </Valores>
    </InstrucaoUnica>
</EnviarInstrucao>";

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://desenvolvedor.moip.com.br/sandbox/ws/alpha/EnviarInstrucao/Unica");
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_USERPWD, $user . ":" . $passwd);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_USERAGENT, "Mozilla/4.0");
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $param);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$ret = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
$xml = new SimpleXMLElement($ret);
echo "<pre>";
print_r($xml);
$token = $xml->Resposta->Token[0];
$url = 'https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token='.$token;
echo $url;

Confira o resultado abaixo do frete com correios usando encomenda normal:

Procuramos programadores apaixonados por tecnologia e desenvolvimento de software, que queiram aprender e contribuir com o nosso time. Não somos apegados a uma tecnologia / metodologia específica, e procuramos empregá- las em função da necessidade de cada projeto.

Para participar, basta criar um, ou mais projetos seguindo o caso de uso descrito abaixo, escrever um documento especificando como instalar o(s) projeto(s), anexar tudo em um arquivo zip junto com o seu currículo. Envie o zip para o e-mail: relacionamento@labs.moip.com.br.

Acesse http://labs.moip.com.br/trabalheconosco/ e saiba mais.

Para que o seu site possua o PagamentoDireto é necessário que ele cumpra algumas exigências. Para saber quais são e pedir a habilitação da funcionalidade na sua conta MoIP, mande um e-mail para integracao@moip.com.br.

A seguir vamos mostrar cada um dos métodos de pagamente usando o Pagamento Único no Sandbox, será mostrado como preparar o XML para fazer o  POST na URL https://desenvolvedor.moip.com.br/sandbox/ws/alpha/EnviarInstrucao/Unica com todas as instruções do pagamento.

Boleto Bancário

Veja o XML abaixo:

<EnviarInstrucao>
    <InstrucaoUnica>
        <Razao>Pagamento direto com boleto</Razao>
        <Valores>
            <Valor moeda=\"BRL\">150.25</Valor>
        </Valores>
        <IdProprio>". rand(1,1000) ."</IdProprio>
        <PagamentoDireto>
            <Forma>BoletoBancario</Forma>
        </PagamentoDireto>
        <Pagador>
            <Nome>Luiz Inácio Lula da Silva</Nome>
            <Email>presidente@planalto.gov.br</Email>
            <TelefoneCelular>(61)9999-9999</TelefoneCelular>
            <Apelido>Lula</Apelido>
            <Identidade>111.111.111-11</Identidade>
            <EnderecoCobranca>
                <Logradouro>Praça dos Três Poderes</Logradouro>
                <Numero>0</Numero>
                <Complemento>Palácio do Planalto</Complemento>
                <Bairro>Zona Cívico-Administrativa</Bairro>
                <Cidade>Brasília</Cidade>
                <Estado>DF</Estado>
                <Pais>BRA</Pais>
                <CEP>70100-000</CEP>
                <TelefoneFixo>(61)3211-1221</TelefoneFixo>
            </EnderecoCobranca>
        </Pagador>
        <Boleto>
            <DiasExpiracao Tipo=\"Corridos\">5</DiasExpiracao>
        </Boleto>
    </InstrucaoUnica>
</EnviarInstrucao>

Nele podemos notar alguns componentes que serão semelhantes em todos os três métodos, são eles: <Razao>, <Valores>, <IdProprio>, <PagamentoDireto> e <Pagador>. No caso do boleto, teremos o campo a mais <Boleto> com informações adicionais ao boleto. Como podemos perceber no campo <PagamentoDireto> basta definir o campo <Forma> com BoletoBancario para implementar o método. Já no campo <Boleto> é passado as intruções quanto ao vencimento do boleto.

Com a instrução XML preparada basta autenticar o seu POST e enviar ao Sandbox. O Sandbox irá retornar um XML informando o resultado da sua transação e confirmada a transação o ID e Token gerado a ser utilizado para gerar a página do boleto através da URL https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token=<Token>.

Veja um exemplo de código em PHP completo para o boleto bancário:

<?php ob_start();
$token = "SEU TOKEN";
$key = "SUA KEY";

$base = $token . ":" . $key;
$auth = base64_encode($base);
$header[] = "Authorization: Basic " . $auth;
$param = "
<EnviarInstrucao>
    <InstrucaoUnica>
        <Razao>Pagamento direto com boleto</Razao>
        <Valores>
            <Valor moeda=\"BRL\">150.25</Valor>
        </Valores>
        <IdProprio>". rand(1,1000) ."</IdProprio>
        <PagamentoDireto>
            <Forma>BoletoBancario</Forma>
        </PagamentoDireto>
        <Pagador>
            <Nome>Luiz Inácio Lula da Silva</Nome>
            <Email>presidente@planalto.gov.br</Email>
            <TelefoneCelular>(61)9999-9999</TelefoneCelular>
            <Apelido>Lula</Apelido>
            <Identidade>111.111.111-11</Identidade>
            <EnderecoCobranca>
                <Logradouro>Praça dos Três Poderes</Logradouro>
                <Numero>0</Numero>
                <Complemento>Palácio do Planalto</Complemento>
                <Bairro>Zona Cívico-Administrativa</Bairro>
                <Cidade>Brasília</Cidade>
                <Estado>DF</Estado>
                <Pais>BRA</Pais>
                <CEP>70100-000</CEP>
                <TelefoneFixo>(61)3211-1221</TelefoneFixo>
            </EnderecoCobranca>
        </Pagador>
        <Boleto>
            <DiasExpiracao Tipo=\"Corridos\">5</DiasExpiracao>
        </Boleto>
    </InstrucaoUnica>
</EnviarInstrucao>";

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://desenvolvedor.moip.com.br/sandbox/ws/alpha/EnviarInstrucao/Unica");
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_USERPWD, $user . ":" . $passwd);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_USERAGENT, "Mozilla/4.0");
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $param);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$ret = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
$xml = new SimpleXMLElement($ret);
$token = $xml->Resposta->Token[0];
$url = 'Location: https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token='.$token;
header($url);

Na imagem a seguir o resultado do código acima:

Débito

No caso do débito os procedimentos serão os mesmos do boleto bancário. Toda a mudança ocorre no XML a ser enviado para o Sandbox, veja como fica:

<EnviarInstrucao>
    <InstrucaoUnica> <!-- Identificador do tipo de instrução -->
    <!-- *********** DADOS OBRIGATÓRIOS *********** -->
        <Razao>Pagamento direto com debito online</Razao>
        <Valores>
             <Valor moeda="BRL">121.75</Valor>
        </Valores>
        <IdProprio>dir_deb_3</IdProprio>
        <PagamentoDireto>
             <Forma>DebitoBancario</Forma>
             <Instituicao>BancoDoBrasil</Instituicao>
        </PagamentoDireto>
        <Pagador>
        	<Nome>Luiz Inácio Lula da Silva</Nome>
        	<LoginMoIP>lula</LoginMoIP>
        	<Email>presidente@planalto.gov.br</Email>
        	<TelefoneCelular>(61)9999-9999</TelefoneCelular>
        	<Apelido>Lula</Apelido>
        	<Identidade>111.111.111-11</Identidade>
        	<EnderecoCobranca>
        		<Logradouro>Praça dos Três Poderes</Logradouro>
        		<Numero>0</Numero>
        		<Complemento>Palácio do Planalto</Complemento>
        		<Bairro>Zona Cívico-Administrativa</Bairro>
        		<Cidade>Brasília</Cidade>
        		<Estado>DF</Estado>
        		<Pais>BRA</Pais>
        		<CEP>70100-000</CEP>
        		<TelefoneFixo>(61)3211-1221</TelefoneFixo>
        	</EnderecoCobranca>
        </Pagador>
    </InstrucaoUnica>
</EnviarInstrucao>

Neste caso é possível perceber não criamos outro campo <Debito> como no caso do boleto, as informações adicionais para a instrução de débito foram passadas dentro com campo <PagamentoDireto>.

Cartão de crédito

Novamente, a mudança na instrução de envio ao Sandbox vai acontecer no XML a ser trocado com o MoIP. Veja exemplo de XML abaixo um exemplo de instrução:

<EnviarInstrucao>
    <InstrucaoUnica> <!-- Identificador do tipo de instrução -->
    <!-- *********** DADOS OBRIGATÓRIOS *********** -->
        <Razao>Pagamento direto com cartão de crédito</Razao>
        <Valores>
             <Valor moeda="BRL">213.25</Valor>
        </Valores>
        <IdProprio>dir_card_2</IdProprio>
        <PagamentoDireto>
             <Forma>CartaoCredito</Forma>
             <Instituicao>AmericanExpress</Instituicao>
             <CartaoCredito>
             	<Numero>345678901234564</Numero>
             	<Expiracao>08/11</Expiracao>
             	<CodigoSeguranca>1234</CodigoSeguranca>
             	<Portador>
             		<Nome>Nome do Portador</Nome>
             		<Identidade Tipo="CPF">111.111.111-11</Identidade>
             		<Telefone>(11)1111-1111</Telefone>
             		<DataNascimento>30/11/1980</DataNascimento>
             	</Portador>
             </CartaoCredito>
             <Parcelamento>
             	<Parcelas>2</Parcelas>
             	<Recebimento>AVista</Recebimento>
             </Parcelamento>
        </PagamentoDireto>
        <Pagador>
        	<Nome>Luiz Inácio Lula da Silva</Nome>
        	<LoginMoIP>lula</LoginMoIP>
        	<Email>presidente@planalto.gov.br</Email>
        	<TelefoneCelular>(61)9999-9999</TelefoneCelular>
        	<Apelido>Lula</Apelido>
        	<Identidade>111.111.111-11</Identidade>
        	<EnderecoCobranca>
        		<Logradouro>Praça dos Três Poderes</Logradouro>
        		<Numero>0</Numero>
        		<Complemento>Palácio do Planalto</Complemento>
        		<Bairro>Zona Cívico-Administrativa</Bairro>
        		<Cidade>Brasília</Cidade>
        		<Estado>DF</Estado>
        		<Pais>BRA</Pais>
        		<CEP>70100-000</CEP>
        		<TelefoneFixo>(61)3211-1221</TelefoneFixo>
        	</EnderecoCobranca>
        </Pagador>
    </InstrucaoUnica>
</EnviarInstrucao>

No caso do cartão de crédito algumas informações complementares foram informadas para a transação, por exemplo, o número do cartão, código de segurança e outros. É muito importante que sua aplicação verifique bem as informações a serem passadas ao MoIP para executar a transação sem falhas.

Mais detalhes sobre como criar uma instrução de pagamento usando a API do PagamentoDireto podem ser vista na documentação da API e através de dúvidas no nosso Fórum.

Que tal começar sua aplicação agora? Divirta-se! =D

Django é um framework Web para desenvolvimento ágil, escrito em Python, que utiliza o padrão MVC (Model-View-Controller), protegido por uma licença BSD hoje se encontra na versão 1.3.1. O nome Django foi inspirado no músico de jazz Django Reinhardt. Django utiliza o princípio DRY (Don’t Repeat Yourself), onde faz com que o desenvolvedor aproveite ao máximo o código já feito, evitando a repetição.

As principais características do Django são:

• Mapeamento Objeto-Relacional (ORM): com o ORM do Django você define a modelagem de dados através de classes em Python. Com isso é possível gerar suas tabelas no banco de dados e manipulá-las sem necessidade de utilizar SQL (o que também é possivel);
• Interface Administrativa: no Django é possivel gerar automaticamente uma interface para administração para os modelos criados através do ORM;
• Formulários: é possível gerar formulários automaticamente através dos modelos de dados;
• URLs Elegantes: no Django não há limitações para criação de URLs elegantes e de maneira simples;
• Sistema de Templates: o Django tem uma linguagem de ”templates” poderosa, extensível e amigável. Com ela você pode separar design, conteúdo e código em Python;
• Sistema de Cache: o Django possui um sistema de ”cache” que se integra ao memcached ou em outros frameworks de cache.
• Internacionalização: Django tem total suporte para aplicações multi-idioma, deixando você especificar strings de tradução e fornecendo ganchos para funcionalidades específicas do idioma.

A instação do Django é bem simples, a maneira mais recomendável é utilizar o pip ou easy_install para facilitar a manutenção nas atualizações:

pip:
$ sudo pip install django
easy_install
$ sudo easy_install django

Após instalado o Django talvez algmas dependências ainda fiquem faltando. Recomenda-se que instale as bibliotecas de Python para suporte a banco de dados de acordo com o banco de dados de deseja utilizar e o docutils para ver as páginas de documentação administrativas do admin.
Feito isso, o desenvolverdo já estará habilitado a criar seu primeiro projeto em Django, para fazer isso basta executar o seguinte comando:

$ django-admin.py startproject exemplo

Agora, com o projeto criado veja como ficou a organização do mesmo:

exemplo/
|-- __init__.py
|-- manage.py
|-- settings.py
|-- urls.py

Então, para iniciar o seu projeto é preciso fazer algumas configurações básicas no projeto.
No arquivo settings.py descomente a linha 7 e insira os seus dados e na linha 14 troque para:

'ENGINE': 'django.db.backends.sqlite3',

Nessa modificação estamos dizendo que o banco de dados a ser utilizado pelo projeto será o SQLite. Agora, na linha 15 insira o caminho para o arquivo que irá conter os dados do projeto:

'NAME':  'exemplo.db',

Na linha 30, tem a opção de TIME_ZONE, no caso desse exemplo foi alteradad para ‘America/Sao_Paulo’, mude para a de sua preferência. Outra opção, na linha 34, é a de linguagem, nesse exemplo mudamos para ‘pt-BR’, na linha acima tem um link para todos códigos possíveis.
Agora, uma funcionalidade interessante a ser habilitada são as páginas do admin, para proceder a instalação descomente as linhas 119 e 121 do settings.py. Com essas modificações o settings.py esta configurado para o exemplo.
Lembre-se de criar o arquivo do banco de dados:

$ touch exemplo.db

Agora, vamos configurar o arquivo urls.py, basta descomentar as linhas 4, 5, 13 e 16, resultando em:

from django.conf.urls.defaults import patterns, include, url

# Uncomment the next two lines to enable the admin:
from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    # Examples:
    # url(r'^$', 'exemplo.views.home', name='home'),
    # url(r'^exemplo/', include('exemplo.foo.urls')),

    # Uncomment the admin/doc line below to enable admin documentation:
    url(r'^admin/doc/', include('django.contrib.admindocs.urls')),

    # Uncomment the next line to enable the admin:
    url(r'^admin/', include(admin.site.urls)),
)

Agora, com as edições básicas feitas é preciso de fato criar o banco de dados, veja:

[root@localhost exemplo]# python manage.py syncdb
Creating tables ...
Creating table auth_permission
Creating table auth_group_permissions
Creating table auth_group
Creating table auth_user_user_permissions
Creating table auth_user_groups
Creating table auth_user
Creating table auth_message
Creating table django_content_type
Creating table django_session
Creating table django_site
Creating table django_admin_log

You just installed Django's auth system, which means you don't have any superusers defined.
Would you like to create one now? (yes/no): yes
Username (Leave blank to use 'root'):
E-mail address: root@exemplo.com
Password:
Password (again):
Superuser created successfully.
Installing custom SQL ...
Installing indexes ...
No fixtures found.

Feita todas as configurações devidas é hora de iniciar o projeto, na ocasião desse exemplo o servidor esta localizado na máquina com IP 192.168.1.125 mas pode ser inciado localmente:

$  python manage.py 192.168.1.125:8000
Validating models...
0 errors found
Django version 1.3.1, using settings 'exemplo.settings'
Development server is running at http://192.168.1.125:8000/
Quit the server with CONTROL-C.

Será possível observar no terminal todo o log HTTP do projeto. Agora, basta ir na url http://192.168.1.125:8000/admin do projeto e autenticar o usuário criado no banco de dados. O login tendo ocorrido com sucesso a página a ser exibida será:

Como foi possível ver nesse artigo é bem simples começar um projeto em Django.
Por hora, finalizamos esse artigo e em próximos artigo veremos como dar continuidade a esse projeto.

Links:
Django: www.djangoproject.com
Django Brasil: www.djangobrasil.org
Django Book: www.djangobook.com
Django Videos: www.djangovideos.com

Atualmente utiliza a tecnologia do MoIP “Pagamento Direto” para fazer toda a integração via web-service. Aceitamos todos os cartões de créditos e boleto bancário.

“Nossa experiência com o pessoal do suporte também tem sido excelente. O MoIP realmente foi um facilitador para o nosso negócio.”

Luis Felipe Luz
Co-fundador Organizze
www.organizze.com.br

Behavior Driven Development

O BDD é uma técnica de desenvolvimento ágil que busca a maior colaboração entre desenvolvedores, gerente de projetos, clientes e outros membros relacionados ao projeto. Criada em 2003 como resposta à Test Driven Development (TDD) e tem se expandido nos últimos tempos. O foco é automatizar testes e prover um feedback rápido e criando testes para avaliar comportamentos da aplicação ou unidades do código.

RSpec

O RSpec é um framework para BDD feito para a linguagem de programação Ruby.  Considerando que o Ruby já tenha sido instalado devidamente para instalar o RSpec basta executar:

$ sudo gem install rspec

Verifique se o comando rspec já esta presente no sistema após a instalação.

BDD com RSpec

Voltando ao foco do artigo agora vamos mostrar um exempĺo de desenvolvimento utilizando ambos.

O problema a ser resolvido será o “Nomes de Autores de Obras Bibliográficas” retirado do Dojo Puzzles, fonte comum de problemas de praticantes de Coding Dojo.

Agora, vamos preparar a organização do projeto para resolver o problema. O RSpec possui um padrão não-obrigatório de organização de diretórios e vamos seguir eles aqui, veja como fica:

$ mkdir author
$ cd author/
$ mkdir lib
$ mkdir spec
$ touch lib/Author.rb
$ touch spec/Author_spec.rb

Com os diretórios e arquivos criados temos a base do projeto pronto. Perceba que em “author/lib” ficará a classe foco de testes e em “author/spec” os testes, é obrigatório o uso do “_spec” no nome do arquivo de teste.

Durante o desenvolvimento do projeto espera-se que os desenvolvedores escrevam gradativamente os testes e criem implementações que resolvam os mesmos até que todo escopo do projeto esteja resolvido. Para simplificar o artigo vamos ver agora um exemplo de teste falhando.

Arquivo Author.rb

#coding: utf-8
class Author
    attr_accessor :names

    def name_for_book
    end

end

Arquivo Author_spec.rb:

#coding: utf-8
require “Author”

describe Author do

    it ‘deveria retorna MENDES, Almir’ do
        author = Author.new(["Almir Mendes"])
        author.name_for_book.should eql([ "MENDES, Almir" ])
    end

end

Rodando o teste:

$ rspec specF
Failures:
1) Author deveria retorna MENDES, Almir
Failure/Error: author.name_for_book.should eql([ "MENDES, Almir" ]) expected ["MENDES, Almir"] got nil (compared using eql?)
# ./spec/Author_spec.rb:9:in `block (2 levels) in ‘
Finished in 0.00058 seconds
1 example, 1 failure
Failed examples:
rspec ./spec/Author_spec.rb:7 # Author deveria retorna MENDES, Almir

Agora, vamos mostrar uma solução para o problema.
Arquivo Author.rb:

# coding: utf-8

class Author
    attr_accessor :names

    def initialize(names=[])
        @names           = names
        @names_especials = ["Neto", "Filho", "Sobrinho", "Neta", "Filha",
                            "Sobrinha", "Junior"]
        @prepositions    = ["da", "de", "do", "das", "dos"]
    end

    def name_for_book
        res = []
        @names.each do |name|
            name_tokens = name.split(" ")
            if name_tokens.size > 1
                surname = name_tokens.delete_at(name_tokens.size - 1)
                if @names_especials.include?(surname.unicode_capitalize) and
                   name_tokens.size > 1 and
                   not @prepositions.include?(name_tokens.last)
                   last_name = name_tokens.delete_at(name_tokens.size - 1)
                   res << last_name.unicode_upcase + " " +
                          surname.unicode_upcase + ", " +
                          capitalize_name(name_tokens).join(" ")
                else
                    res << surname.unicode_upcase + ", " +
                           capitalize_name( name_tokens ).join(" ")
                end
            else
                res << name_tokens.join.upcase
            end
        end

        res
    end

    def capitalize_name(names)
        names.map do |n|
            @prepositions.include?(n.downcase) ? n.downcase : n.unicode_capitalize
        end
    end

end

class String
    def unicode_upcase
        s = ""
        char_map = {"á" => "Á", "à" => "À", "â" => "Â", "ã" => "Ã", "ç" => "Ç",
                    "é" => "É", "è" => "È", "í" => "Í", "ó" => "Ó", "ô" => "Ô",
                    "ú" => "Ú"}
        self.each_char do |c|
            if char_map.include? c
                s += char_map[c]
            else
                s += c.upcase
            end
        end

        s
    end

    def unicode_capitalize
        s = self.downcase
        char_map = {"á" => "Á", "à" => "À", "â" => "Â", "ã" => "Ã", "ç" => "Ç",
                    "é" => "É", "è" => "È", "í" => "Í", "ó" => "Ó", "ô" => "Ô",
                    "ú" => "Ú"}
        if char_map.include? s[0]
            s[0] = char_map[s[0]]
        else
            s.capitalize!
        end

        s
    end

end

Arquivo Author_spec.rb:

#coding: utf-8

require "Author"

describe Author do

    it 'deveria retorna MENDES, Almir' do
        author = Author.new(["Almir Mendes"])
        author.name_for_book.should eql([ "MENDES, Almir" ])
    end

    it "deveria retorna VALLE, Uriel Juliatti" do
        author = Author.new(["Uriel Juliatti Valle"])
        author.name_for_book.should eql([ "VALLE, Uriel Juliatti" ])
    end

    it "deveria retorna ANDREIA" do
        author = Author.new(["Andreia"])
        author.name_for_book.should eql([ "ANDREIA" ])
    end

    it "deveria retornar MENDES, Almir e TAGLIATI, Andre" do
        author = Author.new(["Almir Mendes","Andre Tagliati"])
        author.name_for_book.should eql(["MENDES, Almir","TAGLIATI, Andre"])
    end

    it 'deveria retorna "MENDES NETO, Almir"' do
        author = Author.new(["Almir Mendes Neto"])
        author.name_for_book.should eql(["MENDES NETO, Almir"])
    end

    it 'deveria retorna "SYMEONIDIS JUNIOR, Petros"' do
        author = Author.new(["Petros Symeonidis Junior"])
        author.name_for_book.should eql(["SYMEONIDIS JUNIOR, Petros"])
    end

    it 'deveria retorna "JUNIOR, Petros"' do
        author = Author.new(["Petros Junior"])
        author.name_for_book.should eql(["JUNIOR, Petros"])
    end

    it 'deveria retornar "MENDES, Andreia de"' do
        author = Author.new(["ANDREIA de MENDES"])
        author.name_for_book.should eql(["MENDES, Andreia de"])
    end

    it 'deveria retornar "MENDES, Ághata de"' do
        author = Author.new(["ághata De MENDES"])
        author.name_for_book.should eql(["MENDES, Ághata de"])
    end

    it 'deveria retornar "JUNIOR, Uriel de"' do
        author = Author.new(["Uriel de Junior"])
        author.name_for_book.should eql(["JUNIOR, Uriel de"])
    end

    it 'deveria retornar "NETO, Silva "' do
        author = Author.new(["silva neto"])
        author.name_for_book.should eql(["NETO, Silva"])
    end

    it 'deveria retornar "NETO JUNIOR, Silva dos Santos"' do
        author = Author.new(["silva dos santos neto junior"])
        author.name_for_book.should eql(["NETO JUNIOR, Silva dos Santos"])
    end

    it 'deveria retornar "MC\'LOUD, John"' do
        author = Author.new(["John Mc'loud"])
        author.name_for_book.should eql(["MC'LOUD, John"])
    end

end

Rodando o teste:

$ rspec spec.............
Finished in 0.00402 seconds
13 examples, 0 failures

Agora é praticar, Have Fun!

Utilizando o parâmetro DiasExpiracao em sua aplicação será possível estipular a quantidade de dias desejados para expiração do boleto, para isso é necessário informar os valores Corridos ou Uteis que correspondem a dias corridos ou dias úteis, conforme exemplo:

Código HTML:

      <Boleto>
         <DiasExpiracao Tipo="Corridos">7</DiasExpiracao>
      </Boleto>

Repare que o parâmetro recebe o valor Corridos para definir que o tipo de contagem de dias para vencimento do boleto, no exemplo anterior são 7 dias corridos.

Invés de estipular uma quantidade de dias você também pode fixar uma data fixa para que ocorra o vencimento do boleto utilizando o parâmetro DataVencimento, seguindo exemplo:

Código HTML:

      <Boleto>
         <DataVencimento>2011-04-06T12:01:48.703-02:00</DataVencimento>
      </Boleto>

Ressaltando que o parâmetro recebe um valor em formato dateTime, onde deve ser estipulado conforme exemplo anterior. Para maiores informações orientamos que acesse o seguinte artigo:
http://labs.moip.com.br/forum/showthread.php?17-lt-DataVencimento-gt

Caso os dois parâmetros sejam enviados (DiasExpiracao e DataVencimento), a data de vencimento do boleto será calculada a partir do DiasExpiracao. Caso a data calculada supere a DataVencimento, a DataVencimento é usada no Boleto.

Você também poderá informar o parâmetro Instrucao que exibirá o valor atribuído a mesma no boleto bancário, sendo que é possível a utilização de três parâmetros com a mesma funcionalidade, no caso Instrucao1, Instrucao2 e Instrucao3.

Código HTML:

      <Boleto>
         <Instrucao1>Primeira instrução de pagamento do boleto bancário</Instrucao1>
         <Instrucao2>Segundo teste de instrução</Instrucao2>
         <Instrucao3>Testando terceira instrução</Instrucao3>
      </Boleto>

As informações inseridas no parâmetro em questão deve possuir o formato String e possuir no máximo 63 caracteres.

Além das informações em questão você poderá inserir um logotipo personalizado em seus boletos bancários, para efetuar o procedimento em questão basta utilizar o parâmetro URLLogo.

Código HTML:

      <Boleto>
         <URLLogo>https://desenvolvedor.moip.com.br/sandbox/imgs/logo_moip.gif</URLLogo>
      </Boleto>

No parâmetro você deverá informar a URL onde a imagem de seu logo encontra-se, sendo que a imagem deverá possuir largura de 75 pixels e altura de 40 pixels. Imagens maiores ou menores que o tamanho citado serão automaticamente redimensionadas.

Segue instrução única utilizando todos os parâmetros abordados no tópico:

Utilizando o parâmetro DiasExpiracao :

Código HTML:

<EnviarInstrucao>
 <InstrucaoUnica>
 <Razao>MoIP Labs - Boleto Bancário</Razao>
      	<Valores>
         <Valor moeda="BRL">41</Valor>
	</Valores>
      	<IdProprio>MoIP Labs</IdProprio>
       		<FormasPagamento>
		<FormaPagamento>BoletoBancario</FormaPagamento>
		</FormasPagamento>
	      	<Boleto>
		<DiasExpiracao Tipo="Corridos">7</DiasExpiracao>
		<Instrucao1>Primeira instrução de pagamento do boleto bancário</Instrucao1>
		<Instrucao2>Segundo teste de instrução</Instrucao2>
		<Instrucao3>Testando terceira instrução</Instrucao3>
		<URLLogo>https://desenvolvedor.moip.com.br/sandbox/imgs/logo_moip.gif</URLLogo>
		</Boleto>
	</InstrucaoUnica>
</EnviarInstrucao>

Utilizando o parâmetro DataVencimento:

Código HTML:

<EnviarInstrucao>
 <InstrucaoUnica>
 <Razao>MoIP Labs - Boleto Bancário</Razao>
      	<Valores>
         	<Valor moeda="BRL">41</Valor>
	</Valores>
      	<IdProprio>MoIP Labs</IdProprio>
       	<FormasPagamento>
		<FormaPagamento>BoletoBancario</FormaPagamento>
        </FormasPagamento>
	<Boleto>
	<DataVencimento>2020-04-06T12:01:48.703-02:00</DataVencimento>
	<Instrucao1>Primeira instrução de pagamento do boleto bancário</Instrucao1>
	<Instrucao2>Segundo teste de instrução</Instrucao2>
	<Instrucao3>Testando terceira instrução</Instrucao3>
	<URLLogo>https://desenvolvedor.moip.com.br/sandbox/imgs/logo_moip.gif</URLLogo>
	</Boleto>
	</InstrucaoUnica>
</EnviarInstrucao>

Enjoy!!!

P.S. Esse artigo foi originalmente escrito por Fernando Feitosa (Integração MoIP)