nshop/packages/Webkul/BagistoApi/src/Dto/PaymentCallbackInput.php

<?php

namespace Webkul\BagistoApi\Dto;

use ApiPlatform\Metadata\ApiProperty;
use Symfony\Component\Serializer\Annotation\Groups;
use Symfony\Component\Serializer\Annotation\SerializedName;

/**
 * GraphQL input for paymentCallbackCreate.
 *
 * Frontends call this after the gateway redirects back, indicating
 * `status = success | cancel | failure`. For express success calls
 * the gateway shipping/billing fields populated from the PayPal
 * response should be forwarded so the order address can be filled.
 */
class PaymentCallbackInput
{
    #[Groups(['mutation'])]
    #[ApiProperty(description: 'Bagisto order id created by paymentInitiate')]
    #[SerializedName('orderId')]
    public ?int $orderId = null;

    #[Groups(['mutation'])]
    #[ApiProperty(description: 'Gateway-side order id / token (e.g. PayPal order id)')]
    #[SerializedName('gatewayOrderId')]
    public ?string $gatewayOrderId = null;

    #[Groups(['mutation'])]
    #[ApiProperty(description: 'success | cancel | failure')]
    #[SerializedName('status')]
    public ?string $status = null;

    #[Groups(['mutation'])]
    #[ApiProperty(description: 'Optional signature/proof forwarded from gateway')]
    #[SerializedName('paymentSignature')]
    public ?string $paymentSignature = null;

    /*
    | Optional address payload (express flow only)
    */

    #[Groups(['mutation'])] #[SerializedName('shippingFirstName')] public ?string $shippingFirstName = null;
    #[Groups(['mutation'])] #[SerializedName('shippingLastName')]  public ?string $shippingLastName = null;
    #[Groups(['mutation'])] #[SerializedName('shippingEmail')]     public ?string $shippingEmail = null;
    #[Groups(['mutation'])] #[SerializedName('shippingAddress')]   public ?string $shippingAddress = null;
    #[Groups(['mutation'])] #[SerializedName('shippingCountry')]   public ?string $shippingCountry = null;
    #[Groups(['mutation'])] #[SerializedName('shippingState')]     public ?string $shippingState = null;
    #[Groups(['mutation'])] #[SerializedName('shippingCity')]      public ?string $shippingCity = null;
    #[Groups(['mutation'])] #[SerializedName('shippingPostcode')]  public ?string $shippingPostcode = null;
    #[Groups(['mutation'])] #[SerializedName('shippingPhoneNumber')] public ?string $shippingPhoneNumber = null;

    #[Groups(['mutation'])] #[SerializedName('billingFirstName')] public ?string $billingFirstName = null;
    #[Groups(['mutation'])] #[SerializedName('billingLastName')]  public ?string $billingLastName = null;
    #[Groups(['mutation'])] #[SerializedName('billingEmail')]     public ?string $billingEmail = null;
    #[Groups(['mutation'])] #[SerializedName('billingAddress')]   public ?string $billingAddress = null;
    #[Groups(['mutation'])] #[SerializedName('billingCountry')]   public ?string $billingCountry = null;
    #[Groups(['mutation'])] #[SerializedName('billingState')]     public ?string $billingState = null;
    #[Groups(['mutation'])] #[SerializedName('billingCity')]      public ?string $billingCity = null;
    #[Groups(['mutation'])] #[SerializedName('billingPostcode')]  public ?string $billingPostcode = null;
    #[Groups(['mutation'])] #[SerializedName('billingPhoneNumber')] public ?string $billingPhoneNumber = null;
}