Beta Order Client Payment Collection

Description

A collection of order payments.

Properties

Property Description
items

A collection of resources returned in the current result set.

Property Description
amount

The amount of this payment.

billingPostalCode

The billing address postal code. May be null for order payments made prior to the introduction of this value.

checkNumber nullable

If this payment was made by check, the check number for the payment.

created read-only

The date on which this payment was logged in the system.

currencyCode read-only

Identifies the currency in which this payment was made. This is always the currency of the order; it cannot be set when making a payment.

currencySymbol read-only

The currency symbol for the currency used for this payment.

emailAddress

The email address for the person making the payment.

id

The identifier for this order payment.

isPaymentOnHold nullable read-only

If paymentFundsType is "credit-card" and payment was made with ShootProof Payments, this flag indicates whether the funds for this payment are currently on hold. This is typically the case during a five-day period after credit payment was made, but before ShootProof releases the profit to the Studio.

  • If false, the payment has been released.
  • If null, releasing of funds is not applicable such as when made with cash/check, or a non-ShootProof Payments gateway, such as Authorize.Net, Braintree, or PayPal Pro.
  • If either isPaymentOnHold or isPaymentReleased are non-null, only one of them will be true at any point a time.
isPaymentReleased nullable read-only

If paymentFundsType is "credit-card" and payment was made with ShootProof Payments, this flag indicates whether the funds from this payment have been released.

  • If false, the payment is still on hold.
  • If null, releasing of funds is not applicable such as when made with cash/check, or a non-ShootProof Payments gateway, such as Authorize.Net, Braintree, or PayPal Pro.
  • If either isPaymentOnHold or isPaymentReleased are non-null, only one of them will be true at any point a time.
isRefundable read-only

Whether the payment is able to be refunded.

nameOnCard

The card-holder name.

note nullable

A note about the payment.

paymentDate

The date on which this payment was made.

paymentFundsType

The type of funds received for this payment.

paymentReleasedDate nullable read-only

If isPaymentReleased is true, this indicates the date on which the payment was released.

type

The type of object represented.

links required read-only

Each property defines a hypertext link relationship as indicated by a link object or array of link objects. The target URL of each hypertext link relationship is related to the current resource according to the defined semantics of the link relationship property name.

meta read-only

Metadata describing the current result set.

Property Description
currentPage

The current page of results returned.

rows

The number of rows returned per page for the current result set.

totalItems

The total number of items in the result set. This may be affected by active search/filter parameters.

totalPages

The total number of pages in the result set. This is affected by the rows parameter (totalItems / rows == totalPages).

type

The model type for the list response object.

OpenAPI Schema

The following schema is based on OpenAPI 3.0 and is provided in our downloadable OpenAPI document.

{
  "description": "A collection of order payments.",
  "properties": {
    "items": {
      "description": "A collection of resources returned in the current result set.",
      "items": {
        "description": "An order payment.",
        "properties": {
          "amount": {
            "description": "The amount of this payment.",
            "type": "number"
          },
          "billingPostalCode": {
            "description": "The billing address postal code. May be `null` for order payments\nmade prior to the introduction of this value.",
            "pattern": "^[A-Za-z0-9 -]{0,10}$",
            "type": "string"
          },
          "checkNumber": {
            "description": "If this payment was made by check, the check number for the payment.",
            "nullable": true,
            "type": "integer"
          },
          "created": {
            "description": "The date on which this payment was logged in the system.",
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "currencyCode": {
            "description": "Identifies the currency in which this payment was made. This is\nalways the currency of the order; it cannot be set when making a\npayment.",
            "readOnly": true,
            "type": "string"
          },
          "currencySymbol": {
            "description": "The currency symbol for the currency used for this payment.",
            "readOnly": true,
            "type": "string"
          },
          "emailAddress": {
            "description": "The email address for the person making the payment.",
            "format": "email",
            "type": "string"
          },
          "id": {
            "description": "The identifier for this order payment.",
            "type": "integer"
          },
          "isPaymentOnHold": {
            "description": "If `paymentFundsType` is \"credit-card\" and payment was made with\nShootProof Payments, this flag indicates whether the funds for this\npayment are currently on hold. This is typically the case during a\nfive-day period after credit payment was made, but before ShootProof\nreleases the profit to the Studio.\n\n* If `false`, the payment has been released.\n* If `null`, releasing of funds is not applicable such as when made\nwith cash/check, or a non-ShootProof Payments gateway, such as\nAuthorize.Net, Braintree, or PayPal Pro.\n* If either `isPaymentOnHold` or `isPaymentReleased` are non-null,\nonly one of them will be `true` at any point a time.",
            "nullable": true,
            "readOnly": true,
            "type": "boolean"
          },
          "isPaymentReleased": {
            "description": "If `paymentFundsType` is \"credit-card\" and payment was made with\nShootProof Payments, this flag indicates whether the funds from this\npayment have been released.\n\n* If `false`, the payment is still on hold.\n* If `null`, releasing of funds is not applicable such as when made\nwith cash/check, or a non-ShootProof Payments gateway, such as\nAuthorize.Net, Braintree, or PayPal Pro.\n* If either `isPaymentOnHold` or `isPaymentReleased` are non-null,\nonly one of them will be `true` at any point a time.",
            "nullable": true,
            "readOnly": true,
            "type": "boolean"
          },
          "isRefundable": {
            "description": "Whether the payment is able to be refunded.",
            "readOnly": true,
            "type": "boolean"
          },
          "nameOnCard": {
            "description": "The card-holder name.",
            "type": "string"
          },
          "note": {
            "description": "A note about the payment.",
            "nullable": true,
            "type": "string"
          },
          "paymentDate": {
            "description": "The date on which this payment was made.",
            "format": "date-time",
            "type": "string"
          },
          "paymentFundsType": {
            "description": "The type of funds received for this payment.",
            "enum": [
              "cash",
              "check",
              "credit-card",
              "invoice"
            ],
            "type": "string"
          },
          "paymentReleasedDate": {
            "description": "If `isPaymentReleased` is `true`, this indicates the date on which\nthe payment was released.",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "type": "string"
          },
          "type": {
            "description": "The type of object represented.",
            "enum": [
              "order-payment"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "amount",
          "paymentFundsType",
          "paymentDate"
        ],
        "title": "Order Payment",
        "type": "object",
        "x-beta": true
      },
      "title": "Order Payment",
      "type": "array"
    },
    "links": {
      "$ref": "#/components/schemas/Links"
    },
    "meta": {
      "description": "Metadata describing the current result set.",
      "properties": {
        "currentPage": {
          "description": "The current page of results returned.",
          "type": "integer"
        },
        "rows": {
          "description": "The number of rows returned per page for the current result set.",
          "type": "integer"
        },
        "totalItems": {
          "description": "The total number of items in the result set. This may be\naffected by active search/filter parameters.",
          "type": "integer"
        },
        "totalPages": {
          "description": "The total number of pages in the result set. This is affected by\nthe `rows` parameter (`totalItems / rows == totalPages`).",
          "type": "integer"
        }
      },
      "readOnly": true,
      "type": "object"
    },
    "type": {
      "description": "The model type for the list response object.",
      "enum": [
        "order-payment-collection"
      ],
      "example": "resource-type",
      "title": "Resource Type",
      "type": "string"
    }
  },
  "required": [
    "type",
    "items"
  ],
  "title": "Order Payment Collection",
  "type": "object",
  "x-beta": true
}