COconekta
Charges

Create charge

Changed on

Create charge for an existing orden

post/orders/{id}/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

amountinteger
created_atinteger
currencystring
customer_idstring
descriptionstring
device_fingerprintstring nullable
failure_codestring
failure_messagestring
idstring
livemodeboolean
monthly_installmentsinteger nullable
objectstring
order_idstring
paid_atinteger nullable
reference_idstring nullable

Reference ID of the charge

statusstring

Example response

{
  "amount": 4321,
  "channel": {
    "segment": "Checkout",
    "checkout_request_id": "6fca054a-8519-4c43-971e-cea35cc519bb",
    "checkout_request_type": "HostedPayment",
    "id": "channel_2tNDzhA4Akmzj11AU"
  },
  "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",
  "livemode": true,
  "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",
  "status": "pending_payment"
}

Changes

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