Search Payment Details

You can use the Payments API to list completed payments with transaction details. Then, use the transaction IDs in the response to complete other payment operations. For example, you can issue a refund for a payment, by transaction ID.

List payments with transaction details

To list payments with transaction details, enter query parameters to specify the time range of the transaction, how many payments to list, and the sort order of the payments in the response:

Action	Query parameters	Description
List transactions for a time range	`start_time` `end_time`	Specify the start and end times Internet date and time format. For example: `start_time=2017-03-06T11:00:00Z` and `end_time=2017-03-06T16:00:00Z`
Define how many payments to list in the response	`count`	The response includes the `next_id` link, which is the ID of the next element. In a subsequent list payments calls, set `start_id` to the `next_id` value to get the next set of payments.
Sort payments by create or update time	`sort_by`	Sort payments by the payment `create_time` or `update_time`.

Request

This example request lists ten payments by update time in ascending order:

curl -v -X GET https://api.sandbox.paypal.com/v1/payments/payment?count=10&start_index=0&sort_by=update_time&sort_order=desc \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer Access-Token"

Response

The JSON response body lists payments that match the search criteria. The count field indicates the number of payments in the response. In a subsequent list payments call, set start_id to the next_id value to list the next set of payments.

{
  "payments": [
  {
    "id": "PAY-0US81985GW1191216KOY7OXA",
    "create_time": "2017-06-30T23:48:44Z",
    "update_time": "2017-06-30T23:49:27Z",
    "state": "approved",
    "intent": "order",
    "payer":
    {
      "payment_method": "paypal"
    },
    "transactions": [
    {
      "amount":
      {},
      "description": "The payment transaction description.",
      "item_list":
      {},
      "related_resources": []
    }],
    "links": []
  },
  {},
  {}],
  "count": 3,
  "next_id": "PAY-9X4935091L753623RKOZTRHI"
}

Show payment with transaction details

The show payment details, show sale details, and show captured payment details calls return an array of transactions that include transaction IDs. To show transaction details, call show payment details with a transaction ID.

For example, a payment request returns the following ID:

"id": "PAY-1B56960729604235TKQQIYVY"

Request

To show transaction details, specify the id in the following call:

curl -v -X GET https://api.sandbox.paypal.com/v1/payments/payment/PAY-1B56960729604235TKQQIYVY \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer Access-Token"

Response

The response lists transactions:

{
  "id": "PAY-5YK922393D847794YKER7MUI",
  "create_time": "2017-02-19T22:01:53Z",
  "update_time": "2017-02-19T22:01:55Z",
  "state": "approved",
  "intent": "sale",
  "payer":
  {
    "payment_method": "credit_card",
    "funding_instruments": []
  },
  "transactions": [
  {
    "amount":
    {},
    "description": "The payment transaction description.",
    "note_to_payer": "Contact us for any questions on your order.",
    "related_resources": [
    {
      "sale":
      {
        "id": "36C38912MN9658832",
        "create_time": "2017-02-19T22:01:53Z",
        "update_time": "2017-02-19T22:01:55Z",
        "state": "completed",
        "amount":
        {},
        "protection_eligibility": "ELIGIBLE",
        "protection_eligibility_type": "ITEM_NOT_RECEIVED_ELIGIBLE",
        "transaction_fee":
        {},
        "parent_payment": "PAY-5YK922393D847794YKER7MUI",
        "links": [
        {},
        {},
        {}]
      }
    }]
  }],
  "links": []
}

Additional information

Issue refunds