COconekta
Charges

Update a charge

Changed on
put/charges/{id}

Request

Path parameters

idstring required
Example:6307a60c41de27127515a575

Identifier of the resource

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.

Request body

reference_idstring

custom reference id

Example request

{
  "reference_id": "278482642"
}

Response

successful

amountinteger
conekta_account_idstring nullable

Conekta account ID of the charge, if the charge was paid through a Conekta account.

created_atinteger required

Charge creation date, in seconds since the Unix epoch

currencystring required

Currency of the charge, in ISO 4217 format

customer_idstring
descriptionstring
device_fingerprintstring
failure_codestring
failure_messagestring
idstring required

Charge ID

livemodeboolean required

Whether the charge was made in live mode or not

objectstring required
order_idstring required

Order ID

paid_atinteger nullable

charge Payment date

reference_idstring nullable

Reference ID of the charge

statusstring required

Charge status

Example response

{
  "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

  • 52f4c0dd8a1bRevision 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