luanschons/picpay

此包的最新版本(dev-main)没有可用的许可信息。

dev-main 2022-10-06 22:09 UTC

This package is auto-updated.

Last update: 2024-09-07 02:16:56 UTC


README

Luan Schons Griebler 开发的用于处理 PicPay 付款的 API

在 App/Classes/PicPay.PHP 中配置您的凭据

使用 composer 安装

composer install luanschons/picpay

API 参考

配置访问凭据

  $this->picpayToken = 'Key';
  $this->picpaySellerToken = 'Shop Key'; 

创建付款 URL

$product = [
	'referenceId' 	=> 102040,
	'callbackUrl'  	=> 'http://www.sualoja.com.br/callback',
	'returnUrl'     => 'http://www.sualoja.com.br/cliente/pedido/102030',
	'value' 		=> 20.59,
	'expiresAt' 	=> '2022-05-01T16:00:00-03:00',
	'channel' 		=> 'gram',
	'purchaseMode' 	=> 'in-store',
	'buyer' 		=>
	[
		'firstName' 	=> 'João',
		'lastName' 		=> 'Da Silva',
		'document' 		=> '123.456.789-10',
		'email' 		=> 'teste@picpay.com',
		'phone' 		=> '+55 27 12345-6789'
	]
];

$picpay->payment($product);

取消付款

$product = [
	'referenceId' 	=> 102040,
];

$cancel = $picpay->cancel($product['referenceId']);

if($cancel['status'] === 'success'){
	print_r($cancel['return']['cancellationId']);
}else{
	print_r($cancel['return']);
}

捕获付款状态

$product = [
	'referenceId' 	=> 102040,
];

$status = $picpay->status($product['referenceId']);

if($status['status'] === 'success'){
	print_r($status['return']);
}else{
	print_r($status['return']);
}

PicPay 将通过 POST 方法通知 callbackUrl(在付款请求中提供),告知订单状态已更改。

然而,出于安全考虑,此请求不会提供新的状态。因此,您的商店(从收到通知开始)应查询订单状态端点。

为了使回调被认为是已确认,您的商店必须以 HTTP 状态 200 响应。

更多信息请参考: https://picpay.github.io/picpay-docs-digital-payments/checkout/resources/api-reference/