Como enviar a receber o campo Referencia

O campo Referencia é ótimo para enviar informaçoes que eventualmente você precise ao processar o retorno (EX: O endereço de IP de quem está fazendo a compra). Mas não parece haver documentação confiável sobre o como usar e receber o campo (o que é uma vergonha). Eis o que eu fiz, e funcionou.

(1) Você vai ter de alterar a classe pgs (em pgs.php) adicionado à função pgs um novo elemento. Deve ficar assim:

 function pgs($args = array()) {

 if ('array'!=gettype($args)) $args=array();

 $default = array(

 'email_cobranca' => '',

 'ref_transacao' => '', // <---- é isto que você deve adiconar

 'tipo' => 'CP',

.. etc...

(2) No processamento da compra, você deve inserir a referência:

$Referencia = 'O que você quiser enviar e depois receber';

$pgs=new pgs(array('email_cobranca'=>'SEU EMAIL NO PAGSEGURO', 'ref_transacao'=>$Referencia));

(3) e no processamento do retorno automático TENHA CUIDADO já que a variável retorna como Referencia, e não como foi enviada (ref_transacao)

Veja a definição em retorno.php:

retorno_automatico (....., $post['Referencia'], ...)

entretanto, sua sua definição da função você pode usar o nome que quiser:

function retorno_automatico

(

$emailDoVendedor, $idDaTransacao, $referenciaDaTransacao, $tipoDoFrete, ... etc.

A variável $referenciaDaTransacao (ou como você a chame) terá o valor que você enviou em ref_transacao

Boa sorte !