COconekta
Charges

Create charges

Changed on

Create charges for an existing orden

post/orders/{id}/add_charges

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.

Idempotency-Keystring

Unique key to make the request idempotent. Retrying a request with the same key returns the original response instead of performing the operation again.

Request body

amountinteger

Amount to be charged in cents

reference_idstring

Custom reference to add to the charge

Example request

{
  "amount": 40000,
  "payment_method": {
    "type": "pay_by_bank",
    "expires_at": 1680397724,
    "product_type": "bbva_pay_by_bank"
  }
}

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

  • 52f4c0dd8a1bRevision changes
    • breaking

      the response property /// became optional for the status

    • warning

      the /// request property's maxLength was set to 249

    • warning

      removed the request property ///

    • info

      added the new optional header request parameter Idempotency-Key

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      the request property /// became optional

    • info

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

    • info

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