1
0
Files
PayPal-PHP-Server-SDK/doc/models/payment-authorization.md
Patrick Powers 504c367386 Release 0.7.0
Beta Release 0.7.0 including:

- Bug fixes
- Updated model/function names
- Updated models to reflect changes in APIs
2025-03-20 13:18:55 -05:00

5.0 KiB

Payment Authorization

The authorized payment transaction.

Structure

PaymentAuthorization

Fields

Name Type Tags Description Getter Setter
status ?string(AuthorizationStatus) Optional The status for the authorized payment. getStatus(): ?string setStatus(?string status): void
statusDetails ?AuthorizationStatusDetails Optional The details of the authorized payment status. getStatusDetails(): ?AuthorizationStatusDetails setStatusDetails(?AuthorizationStatusDetails statusDetails): void
id ?string Optional The PayPal-generated ID for the authorized payment. getId(): ?string setId(?string id): void
amount ?Money Optional The currency and amount for a financial transaction, such as a balance or payment due. getAmount(): ?Money setAmount(?Money amount): void
invoiceId ?string Optional The API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives. getInvoiceId(): ?string setInvoiceId(?string invoiceId): void
customId ?string Optional The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.
Constraints: Maximum Length: 255
getCustomId(): ?string setCustomId(?string customId): void
networkTransactionReference ?NetworkTransactionReference Optional Reference values used by the card network to identify a transaction. getNetworkTransactionReference(): ?NetworkTransactionReference setNetworkTransactionReference(?NetworkTransactionReference networkTransactionReference): void
sellerProtection ?SellerProtection Optional The level of protection offered as defined by PayPal Seller Protection for Merchants. getSellerProtection(): ?SellerProtection setSellerProtection(?SellerProtection sellerProtection): void
expirationTime ?string Optional The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional. Note: The regular expression provides guidance but does not reject all invalid dates.
Constraints: Minimum Length: 20, Maximum Length: 64, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$
getExpirationTime(): ?string setExpirationTime(?string expirationTime): void
links ?(LinkDescription[]) Optional An array of related HATEOAS links. getLinks(): ?array setLinks(?array links): void
createTime ?string Optional The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional. Note: The regular expression provides guidance but does not reject all invalid dates.
Constraints: Minimum Length: 20, Maximum Length: 64, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$
getCreateTime(): ?string setCreateTime(?string createTime): void
updateTime ?string Optional The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional. Note: The regular expression provides guidance but does not reject all invalid dates.
Constraints: Minimum Length: 20, Maximum Length: 64, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$
getUpdateTime(): ?string setUpdateTime(?string updateTime): void
supplementaryData ?PaymentSupplementaryData Optional The supplementary data. getSupplementaryData(): ?PaymentSupplementaryData setSupplementaryData(?PaymentSupplementaryData supplementaryData): void
payee ?PayeeBase Optional The details for the merchant who receives the funds and fulfills the order. The merchant is also known as the payee. getPayee(): ?PayeeBase setPayee(?PayeeBase payee): void

Example (as JSON)

{
  "status": "VOIDED",
  "status_details": {
    "reason": "PENDING_REVIEW"
  },
  "id": "id0",
  "amount": {
    "currency_code": "currency_code6",
    "value": "value0"
  },
  "invoice_id": "invoice_id0"
}