Charges

Get A List of Charges

Changed on
get/charges

Request

Query parameters

limitinteger

The numbers of items to return, the maximum value is 250

searchstring

General order search, e.g. by mail, reference etc.

nextstring

next page

previousstring

previous page

Headers

Accept-Language'es' | 'en'

Use for knowing which language to use

X-Child-Company-Idstring

In the case of a holding company, the company id of the child company to which will process the request.

Response

successful

has_moreboolean required

Indicates if there are more pages to be requested

objectstring required

Object type, in this case is list

next_page_urlstring nullable

URL of the next page.

previous_page_urlstring nullable

Url of the previous page.

Example response

{
  "object": "list",
  "next_page_url": "https://api.conekta.io/resources?limit=10&next=chrg_1",
  "previous_page_url": "https://api.conekta.io/resources?limit=10&previous=chrg_1",
  "data": [
    {
      "amount": 4321,
      "channel": {
        "segment": "Checkout",
        "checkout_request_id": "6fca054a-8519-4c43-971e-cea35cc519bb",
        "checkout_request_type": "HostedPayment",
        "id": "channel_2tNDzhA4Akmzj11AU"
      },
      "conekta_account_id": "019ff731-2448-7a6b-b95b-5d4a36035da9",
      "created_at": 1676386026,
      "currency": "MXN",
      "description": "Payment from order",
      "device_fingerprint": "6FR3chaU4Y1nGAW5NAGd1rcjAKa142Ba",
      "failure_code": "suspected_fraud",
      "failure_message": "Este cargo ha sido declinado porque el comportamiento del comprador es sospechoso.",
      "id": "63efa757cf65380001aec040",
      "next_action": {
        "redirect_to_url": {
          "url": "https://pay.conekta.com/6fca054a85194c43971ecea35cc519bb",
          "return_url": "https://my-website.com\""
        },
        "type": "redirect_to_url"
      },
      "object": "charge",
      "order_id": "ord_2tN73UdUSNrYRPD9r",
      "paid_at": 1676390742,
      "payment_method": {
        "object": "payment_source",
        "agreement": "agreement_2tN73UdUSNrYRPD9r",
        "auth_code": 542563,
        "cashier_id": "OINM01010",
        "reference": "93000262276908",
        "barcode_url": "https://barcodes.conekta.com/644ebf80f2243197aad6cd8810375b905b613dbe.png",
        "product_type": "bbva_cash_in",
        "service_name": "store",
        "store": "10MON50EDI",
        "store_name": "wallmart",
        "customer_ip_address": "0.0.0.0"
      },
      "reference_id": "ref_2tN73UdUSNrYRPD9r",
      "refunds": {
        "object": "list",
        "next_page_url": "https://api.conekta.io/resources?limit=10&next=chrg_1",
        "previous_page_url": "https://api.conekta.io/resources?limit=10&previous=chrg_1",
        "data": [
          {
            "amount": -15000,
            "auth_code": "867372",
            "created_at": 1678226878,
            "expires_at": 1678226878,
            "id": "6407b5bee1329a000175ba11",
            "object": "refund",
            "status": "pending"
          }
        ]
      },
      "chargeback": {
        "id": "chbk_2zPxWFUnGNLySoumn",
        "status": "lost",
        "reason": "unrecognized",
        "files": [
          {
            "id": "chbkf_2zPxWFUnGNLySoums",
            "file_name": "20251221500000000000201.pdf",
            "created_at": 1768846800
          }
        ],
        "object": "chargeback",
        "charge_id": "6966a06c044243000156c24d",
        "created_at": 1768846800,
        "evidence_due_by": 1769126399
      },
      "status": "pending_payment"
    }
  ]
}

Changes

    • breaking

      the response property /// became optional for the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status