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
Customerdo Mercado Pago existe para cartões salvos — não é pré-requisito para cobrar, já que o pagamento carregapayer.emaildireto. A API também não oferece exclusão de cliente.
$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úvidaValores 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 aceitarMoney|int|float|nulle a ser chamado$amount, para ficar igual aos outros gateways. Número cru continua lido em reais, como sempre foi.