Struct Buyer 

#[non_exhaustive]
pub struct Buyer {
    pub name: Box<str>,
    pub surname: Option<Box<str>>,
    pub email: Box<str>,
    pub phone: Option<Box<str>>,
    pub identity_number: Option<Box<str>>,
    pub ip: Option<Box<str>>,
    pub address: Option<Address>,
}

The person paying.

Only the name and the email are required here, because they are the two every provider that asks for a buyer asks for. The rest are Option because which of them is mandatory is the provider’s own decision — iyzico refuses a payment without an identity number, PayTR without the payer’s IP — and an adapter says which one is missing when it needs it.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: Box<str>

Given name. A provider that wants one field takes this.

surname: Option<Box<str>>

Family name, where the provider keeps them apart. iyzico does.

email: Box<str>

Email address.

phone: Option<Box<str>>

Mobile number.

identity_number: Option<Box<str>>

Turkish national identity number, or the equivalent. iyzico’s classic API requires one on every hosted form.

ip: Option<Box<str>>

The address the request came from, which fraud checks read. PayTR requires it.

address: Option<Address>

Where the payer is registered, which iyzico sends as registrationAddress and PayTR as the payer’s address.

Implementations

impl Buyer

pub fn new(name: impl Into<Box<str>>, email: impl Into<Box<str>>) -> Self

A buyer with the two fields every provider that wants one asks for.

pub fn surname(self, surname: impl Into<Box<str>>) -> Self

Adds the family name.

pub fn phone(self, phone: impl Into<Box<str>>) -> Self

Adds the mobile number.

pub fn identity_number(self, identity_number: impl Into<Box<str>>) -> Self

Adds the national identity number.

pub fn ip(self, ip: impl Into<Box<str>>) -> Self

Adds the address the request came from.

pub fn address(self, address: Address) -> Self

Adds where the payer is registered.

Trait Implementations

impl Clone for Buyer

fn clone(&self) -> Buyer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Buyer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Buyer

impl PartialEq for Buyer

fn eq(&self, other: &Buyer) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Buyer