Criar um pedido com split de pagamentos

Criando um pedido com split de pagamentos (vários recebedores)

Com a API da Moip é possível criar um pedido com pagamento distribuído entre vários recebedores. Através da SDK de PHP podemos fazer isso usando o método addReceiver, como veremos abaixo.

A variável $moip no exemplo é um objeto do tipo Moip que garante a autenticação básica, como você pode conferir na seção Como Começar

try {
    $order = $moip->orders()->setOwnId(uniqid())
        ->addItem("bicicleta 1",1, "sku1", 10000)
        ->addItem("bicicleta 2",1, "sku2", 11000)
        ->addItem("bicicleta 3",1, "sku3", 12000)        
        ->setShippingAmount(3000)
	->setAddition(1000)
	->setDiscount(5000)
        ->setCustomer($customer);
    $order->addReceiver('MPA-7ED9D2D3BC81', 'PRIMARY', 30000, null, true)
          ->addReceiver('MPA-8D5DBB4EF8B7', 'SECONDARY', 2000, null, false)
        ->create();

    print_r($order);
} catch (Exception $e) {
    printf($e->__toString());
}

Veja que é necessário passar o ID da conta moip do recebedor e se o mesmo é primário ou secundário. Neste exemplo definimos que o recebedor primário receberá 300,00 e o secundário 20,00. Sempre que há mais que um recebedor é necessário passar o valor que cada um receberá. É possível passar o valor em percentual, passando-o através do 4º parâmetro, como podemos ver abaixo.

$order->addReceiver('MPA-7ED9D2D3BC81', 'PRIMARY', null, 3, false);

No caso acima definimos como 3% o valor percentual a ser recebido. Por fim, o último parâmetro do método addReceiver é o feePayor, que define quem é o pagador da taxa moip, se o feePayor não for informado, o recebedor type PRIMARY será o pagador da taxa Moip. Se houver mais de um recebedor tipo SECONDARY, apenas um deles poderá ser o pagador da taxa.