Charges
Get A List of Charges
Changed onget/charges
Request
- Base URLhttps://api.conekta.io
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
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
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
- breaking