Skip to content

Latest commit

 

History

History
67 lines (53 loc) · 2.32 KB

mercado-pago.md

File metadata and controls

67 lines (53 loc) · 2.32 KB

Mercado Pago

Ambiente pelo prefixo do token. POST /v1/payments exige o header X-Idempotency-Key: o PHPay gera uma chave por chamada, e setIdempotencyKey() deixa você fixar a sua — assim um retry da mesma operação de negócio não cria duas cobranças.

use PHPay\MercadoPago\Enums\PaymentMethodEnum;
use PHPay\MercadoPago\MercadoPagoGateway;

$gateway = new MercadoPagoGateway(ACCESS_TOKEN);

$cobranca = PHPay::gateway($gateway)->charge()
    ->setCharge([
        'transaction_amount' => 100.50,
        'payment_method_id'  => PaymentMethodEnum::PIX->value,
        'notification_url'   => 'https://exemplo.test/webhook/mercadopago',
    ])
    ->setPayer(['email' => 'comprador@exemplo.test'])
    ->setIdempotencyKey('pedido-123456')
    ->create();

$phpay->getPixCode($cobranca['id']);

Assinaturas usam /preapproval, com ou sem plano associado:

$phpay = PHPay::gateway($gateway)->subscription();

$phpay->setPayerEmail('comprador@exemplo.test')->create([
    'reason'         => 'Assinatura PHPay',
    'back_url'       => 'https://exemplo.test/retorno',
    'auto_recurring' => [
        'frequency'          => 1,
        'frequency_type'     => 'months',
        'transaction_amount' => 100.50,
        'currency_id'        => 'BRL',
    ],
]);

/* com plano, a recorrência vem do plano */
$phpay->setPayerEmail('comprador@exemplo.test')
    ->setPlan('2c938084726fca480172750000000000')
    ->create(['back_url' => 'https://exemplo.test/retorno']);

O recurso Customer do Mercado Pago existe para cartões salvos — não é pré-requisito para cobrar, já que o pagamento carrega payer.email direto. A API também não oferece exclusão de cliente.

Estorno

$phpay->refund($paymentId);                       // devolve tudo
$phpay->refund($paymentId, 25.50);                // devolve parte, em reais
$phpay->refund($paymentId, Money::reais(25.50));  // o mesmo, sem dúvida

Valores em reais com decimais, como no resto da API do Mercado Pago — e diferente dos sete gateways que trabalham em centavos. A chamada já vai com X-Idempotency-Key, que esta API exige.

Até a v2.4 o segundo parâmetro era ?float $value. Ele passou a aceitar Money|int|float|null e a ser chamado $amount, para ficar igual aos outros gateways. Número cru continua lido em reais, como sempre foi.