Type Reference

interface PaymentRequest {
  price: string;
  paidPrice: string;
  currency: Currency;
  installment?: number;
  paymentCard: PaymentCard;
  buyer: Buyer;
  shippingAddress: Address;
  billingAddress: Address;
  basketItems: BasketItem[];
  conversationId?: string;
}

interface PaymentCard {
  cardHolderName: string;
  cardNumber: string;
  expireMonth: string;
  expireYear: string;
  cvc: string;
  registerCard?: number;
}

interface Buyer {
  id: string;
  name: string;
  surname: string;
  email: string;
  identityNumber: string;
  registrationAddress: string;
  city: string;
  country: string;
  ip: string;
  zipCode?: string;
  mobilePhoneNumber?: string;
}

interface Address {
  contactName: string;
  city: string;
  country: string;
  address: string;
  zipCode?: string;
}

interface BasketItem {
  id: string;
  name: string;
  category1: string;
  category2?: string;
  itemType: BasketItemType;
  price: string;
}

enum Currency {
  TRY = 'TRY',
  USD = 'USD',
  EUR = 'EUR',
  GBP = 'GBP',
}

enum BasketItemType {
  PHYSICAL = 'PHYSICAL',
  VIRTUAL = 'VIRTUAL',
}

enum PaymentStatus {
  SUCCESS = 'success',
  FAILURE = 'failure',
  PENDING = 'pending',
}

enum ProviderType {
  IYZICO = 'iyzico',
  PAYTR = 'paytr',
  AKBANK = 'akbank',
  PARAMPOS = 'parampos',
}

interface PaymentResponse {
  status: PaymentStatus;
  paymentId?: string;
  errorMessage?: string;
  errorCode?: string;
  conversationId?: string;
  rawResponse?: unknown;
}

interface ThreeDSInitResponse {
  status: PaymentStatus;
  htmlContent?: string;     // İyzico — embed in page
  redirectUrl?: string;     // some providers
  token?: string;           // PayTR — use in iframe URL
  errorMessage?: string;
  rawResponse?: unknown;
}

interface RefundResponse {
  status: PaymentStatus;
  refundedAmount?: string;
  errorMessage?: string;
  rawResponse?: unknown;
}

interface CancelResponse {
  status: PaymentStatus;
  errorMessage?: string;
  rawResponse?: unknown;
}