1
0
Files
PayPal-PHP-Server-SDK/doc/models/authorization.md
2025-05-27 17:46:31 +00:00

4.5 KiB

Authorization

The authorized payment transaction.

Structure

Authorization

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

Example (as JSON)

{
  "status": "CREATED",
  "status_details": {
    "reason": "PENDING_REVIEW"
  },
  "id": "id8",
  "amount": {
    "currency_code": "currency_code6",
    "value": "value0"
  },
  "invoice_id": "invoice_id8"
}