Payments / Manage payments / Get payment actions

Get payment actions

Last updated: 14th July 2022

Find out all you need to know about history of a payment. This API provides details about each step of the payment lifecycle.

Get payment actions

Use the details below to set up your request. In the URI, replace {id} with the payment_id.

Endpoints

For the full API specification, see the API reference.

get

https://api.checkout.com/payments/{id}/actions

Response example

If successful, you should get a 200 Success response returning a list of data relating to the payment.

[
  {
    "id": "act_fd3h6evhpn3uxdoqbuu3lqnqbm",
    "type": "Refund",
    "processed_on": "2018-01-20T10:30:48Z",
    "amount": 1000,
    "approved": true,
    "response_code": "10000",
    "response_summary": "Approved"
  },
  {
    "id": "act_gefycn3jcvuupboxfmqrhk2aym",
    "type": "Capture",
    "processed_on": "2018-01-17T10:30:48Z",
    "amount": 6540,
    "approved": true,
    "response_code": "10000",
    "response_summary": "Approved",
    "processing": {
      "acquirer_reference_number": "24021219099007452440793",
      "acquirer_transaction_id": "00745244079"
    },
    "metadata": {
      "shipping_ref": "MQIBN2"
    }
  },
  {
    "id": "act_y3oqhf46pyzuxjbcn2giaqnb44",
    "type": "Authorization",
    "processed_on": "2018-01-17T09:30:48Z",
    "amount": 6540,
    "approved": true,
    "auth_code": "643381",
    "response_code": "10000",
    "response_summary": "Approved",
    "reference": "ORD-5023-4E89",
    "processing": {
      "retrieval_reference_number": "909913440644",
      "acquirer_transaction_id": "440644309099499894406"
    }
  }
]

If your request is unsuccessful, you may receive a 404 – Payment not found error.

Response parameters

Find out what the different fields in your successful response mean by looking at our API reference.

Payment actions

The table below outlines the different payment actions and their meanings.

`Authorization`	The payment request was sent successfully.
`Capture`	The authorized payment was captured in full.
`Refund`	Part or all of the captured amount was refunded.
`Void`	The payment was voided and never captured; the funds were returned to the customer.
`Card Verification`	The card verification request has been approved and the cardholder’s details have been saved to their account.
`Payout`	Thecard payout was processed successfully.