sfp_api_laravel_diarista/app/Services/Pagarme/PagarmeCustomerService.php

<?php

namespace App\Services\Pagarme;

use App\Data\Pagarme\Request\PagarmeCustomerRequestData\PagarmeCustomerAddressRequestData;
use App\Data\Pagarme\Request\PagarmeCustomerRequestData\PagarmeCustomerPhonesRequestData\PagarmeCustomerPhoneData;
use App\Data\Pagarme\Request\PagarmeCustomerRequestData\PagarmeCustomerPhonesRequestData\PagarmeCustomerPhonesRequestData;
use App\Data\Pagarme\Request\PagarmeCustomerRequestData\PagarmeCustomerRequestData;
use App\Data\Pagarme\Response\PagarmeCustomerResponseData\PagarmeCustomerResponseData;
use App\Models\Client;
use App\Services\Pagarme\Concerns\SendsPagarmeRequests;
use Illuminate\Support\Str;

class PagarmeCustomerService
{
    use SendsPagarmeRequests;

    public function createCustomerForClient(Client $client, array $data): ?string
    {
        if (! empty($client->external_customer_id)) {
            return $client->external_customer_id;
        }

        $client->loadMissing('user');

        $name  = $client->user?->name ?? $data['name'] ?? 'Cliente';
        $email = $client->user?->email ?? $data['email'] ?? null;
        $code  = $this->ensureCustomerCode($client);

        $document    = $this->onlyDigits($client->document ?? $data['document'] ?? null);
        $documentLen = strlen($document);

        $address = $this->buildAddressData($data);
        $phones  = $this->buildPhones($client->user?->phone ?? $data['phone'] ?? null);

        $customerRequest = new PagarmeCustomerRequestData(
            name:         $name,
            email:        (string) $email,
            document:     $document,
            type:         $documentLen === 14 ? 'company' : 'individual',
            documentType: $documentLen === 14 ? 'CNPJ' : 'CPF',
            code:         $code,
            address:      $address,
            phones:       $phones,
        );

        $customerData = PagarmeCustomerResponseData::fromArray($this->pagarmeRequest(
            method: 'POST',
            path: '/customers',
            payload: $customerRequest,
            idempotencyKey: $this->idempotencyKey($client->id),
            errorMessage: 'Erro ao criar cliente no Pagar.me.',
        ));

        $customerId = $customerData->requireId();

        $client->forceFill([
            'external_customer_id'   => $customerId,
            'external_customer_code' => $code,
        ])->save();

        return $customerId;
    }

    //

    private function buildAddressData(array $data): PagarmeCustomerAddressRequestData
    {
        $line1Parts = array_filter([
            (string) ($data['number'] ?? '0'),
            (string) ($data['address'] ?? ''),
            (string) ($data['district'] ?? ''),
        ], static fn ($value) => $value !== '');

        return new PagarmeCustomerAddressRequestData(
            line1:   implode(', ', $line1Parts),
            line2:   (string) ($data['complement'] ?? $data['instructions'] ?? ''),
            zipCode: $this->onlyDigits($data['zip_code'] ?? null),
            city:    (string) ($data['city'] ?? ''),
            state:   (string) ($data['state'] ?? ''),
            country: (string) ($data['country'] ?? 'BR'),
        );
    }

    private function buildPhones(?string $phone): PagarmeCustomerPhonesRequestData
    {
        $digits = $this->onlyDigits($phone);

        if ($digits === '') {
            return new PagarmeCustomerPhonesRequestData;
        }

        $areaCode = substr($digits, 0, 2);
        $number   = substr($digits, 2);

        if (strlen($digits) <= 2) {
            $areaCode = '';
            $number   = $digits;
        }

        return new PagarmeCustomerPhonesRequestData(
            mobilePhone: new PagarmeCustomerPhoneData(
                countryCode: '55',
                areaCode:    $areaCode,
                number:      $number,
            ),
        );
    }

    private function onlyDigits(?string $value): string
    {
        return preg_replace('/\D+/', '', (string) $value) ?? '';
    }

    // evita criacao duplicada de customer

    private function idempotencyKey(int $clientId, string $suffix = 'customer'): string
    {
        return "client-{$clientId}-{$suffix}";
    }

    private function ensureCustomerCode(Client $client): string
    {
        if (! empty($client->external_customer_code)) {
            return $client->external_customer_code;
        }

        $code = 'client-'.(string) Str::uuid();

        $client->forceFill(['external_customer_code' => $code])->save();

        return $code;
    }
}