althosalud / cobros

v1.0.0 2026-09-12 23:44 UTC

Requires

• php: >=8.2
• ext-curl: *
• ext-hash: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0 || ^12.0

proprietary

Published on Packagist.org on 2026-09-12 23:48 UTC

README

Cliente PHP tipado para la AlthoCobros Checkout API.

Sin dependencias de framework: PHP 8.2+, ext-curl, ext-hash.

• Packagist: althosalud/cobros
• Repo: gonzaloalonsod/althos-cobros-php
• Contrato HTTP: https://cobros.althosalud.com/api/docs (OpenAPI). Este SDK no calcula precios.

Instalación

composer require althosalud/cobros

Uso

use AlthoSalud\Cobros\CobrosClient;
use AlthoSalud\Cobros\EntitlementSignature;

$client = new CobrosClient(
    baseUrl: 'https://cobros.althosalud.com',
    apiKey: 'cb_...',
);

$me = $client->me();

$checkout = $client->createCheckout([
    'customer_external_id' => 'org-42',
    'lines' => [[
        'amount_cents' => 15000,
        'currency' => 'ARS',
        'description' => 'Plan mensual',
        'sku' => 'althasalud.pro',
        'period_start' => '2026-08-01',
        'period_end' => '2026-08-31',
        'entitlement_ref' => 'org-42:2026-08',
    ]],
], idempotencyKey: 'org-42-2026-08');

// Redirect the payer:
$checkout->initPoint;

$paid = $client->getCheckout($checkout->id);

Webhook entitlement.paid

$event = EntitlementSignature::parse(
    rawBody: $request->getContent(),
    signatureHeader: (string) $request->headers->get('X-Cobros-Signature'),
    secret: $applicationWebhookSecret,
    idempotencyKey: $request->headers->get('X-Cobros-Idempotency-Key'),
);
// $event->sku, amountCents, periodStart, customerExternalId

withApiKey() is immutable (one key per tenant).