Consulta Devolución cobrada

En esta documentación conocerás cómo identificar si un Devolución en Efectivo fue cobrada en OXXO.

Eventos

Cuando una Devolución de Efectivo sea cobrada en caja OXXO se enviará al webhook configurado el evento cash_refund.refunded

{
  "object":{
    "id":"63dd1ccaaf43b2a9c0cde37a", 
    "object":"cash_refund", 
    "amount":10000, 
    "currency":"MXN", 
    "status":"refunded", 
    "reference":"************0832", 
    "payout_order_id":"4a199053-bf85-434e-a61b-77d6bbe01bfa", 
    "created_at":1675435210
  }, 
  "previous_attributes":{}
}

En caso de que la Devolución sea total también se enviará el evento charge.refunded

{
  "object": {
    "id": "63dd1ccaaf43b2a9c0cde376",
    "livemode": true,
    "created_at": 1675435210,
    "currency": "MXN",
    "description": "A product",
    "reference_id": nil,
    "failure_code": nil,
    "failure_message": nil,
    "monthly_installments": nil,
    "device_fingerprint": nil,
    "channel": nil,
    "refunds": [
      {
        "object":"cash_refund", 
        "amount":10000, 
        "currency":"MXN", 
        "status":"refunded", 
        "reference":"6355441254890832", 
        "payout_order_id":"4a199053-bf85-434e-a61b-77d6bbe01bfa", 
        "id":"63dd1ccaaf43b2a9c0cde37a", 
        "created_at":1675435210
       }    
    ],
    "payment_method": {
      "barcode": nil,
      "reference": "994v8on4ge4heb",
      "barcode_url": nil,
      "store": nil,
      "auth_code": 4921,
      "object": "cash_payment",
      "type": "oxxo",
      "expires_at": 1677801600,
      "store_name": "OXXO"
    },
    "details": {
      "name": "Usuario",
      "phone": "1473653033452",
      "email": "[email protected]",
      "line_items": [
        {
          "name": "test",
          "description": "test",
          "unit_price": 500,
          "quantity": 100,
          "sku": nil,
          "category": nil,
          "object": "line_item"
        }
      ],
      "coupons": [],
      "object": "details"
    },
    "object": "charge",
    "status": "refunded",
    "amount": 10000,
    "paid_at": nil,
    "fee": 1485,
    "customer_id": "",
    "subscription_id": "",
    "amount_refunded": 10000
  },
  "previous_attributes": {
  }
}

En caso de que la Devolución sea parcial también se enviará el evento charge.partially_refunded

{
  "object": {
    "id": "63dd1ccaaf43b2a9c0cde3ee",
    "livemode": true,
    "created_at": 1675435210,
    "currency": "MXN",
    "description": "A product",
    "reference_id": nil,
    "failure_code": nil,
    "failure_message": nil,
    "monthly_installments": nil,
    "device_fingerprint": nil,
    "channel": nil,
    "refunds": [
      {
        "id": "63dd1ccaaf43b2a9c0cde3f2",
        "object": "cash_refund",
        "amount": 5000,
        "currency": "MXN",
        "status": "refunded",
        "reference": "6325412547850832",
        "payout_order_id": "e6fa6512-2184-41d2-bf2e-791f454a1786",
        "created_at": 1675435210
      },
      {
        "id": "63dd1ccaaf43b2a9c0cde3f2",
        "object": "cash_refund",
        "amount": 1000,
        "currency": "MXN",
        "status": "pending",
        "reference": "************0855",
        "payout_order_id": "e6fa6512-2184-41d2-bf2e-791f454a5588",
        "created_at": 1675439999
      }
    ],
    "payment_method": {
      "barcode": nil,
      "reference": "99f19kdfbycso4",
      "barcode_url": nil,
      "store": nil,
      "auth_code": 6136,
      "object": "cash_payment",
      "type": "oxxo",
      "expires_at": 1677801600,
      "store_name": "OXXO"
    },
    "details": {
      "name": "Guadalupe Ibarra Gamboa",
      "phone": "30695997115",
      "email": "[email protected]",
      "line_items": [
        {
          "name": "test",
          "description": "test",
          "unit_price": 500,
          "quantity": 100,
          "sku": nil,
          "category": nil,
          "object": "line_item"
        }
      ],
      "coupons": [],
      "object": "details"
    },
    "object": "charge",
    "status": "partially_refunded",
    "amount": 10000,
    "paid_at": nil,
    "fee": 1485,
    "customer_id": "",
    "subscription_id": "",
    "amount_refunded": 5000
  },
  "previous_attributes": {
  }
}