1
0
Files
PayPal-PHP-Server-SDK/doc/models/payment-authorization.md
Dani Kirby 6b43a4225b Beta Release 0.5.0 (#3)
* Automated commit message

* Automated commit message

* Automated commit message

* Automated commit message

---------

Co-authored-by: PayPalServerSDKs <server-sdks@paypal.com>
2024-09-09 12:10:34 -05:00

5.1 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 ?Payee Optional The details for the merchant who receives the funds and fulfills the order. The merchant is also known as the payee. getPayee(): ?Payee setPayee(?Payee 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"
}