# Webhook --- - [Webhook](#webhook) - [Overview](#overview) - [Webhook](#webhook) ## Overview [#overview] Gracias a nuestro webhook podras recibir en tu sistema el status de una transacción realizada desde un formulario de cobra plus y recibir la información asi como el estado aprobado, rechazado... Este webhook se envia al endpoint colocado en las opciones avanzadas en los urls de resultados. :::note Recuerda que esta ruta debe ser de tipo **post**. Ademas te enviaremos un header **Signature** que contendrá una firma que podras usar para verificar que la carga útil no haya sido manipulada. Para realizar la firma usamos el token como secreto para el webhook que generamos en tu comercio, lo puedes encontrar [aquí](https://sag.efipay.co/documentacion/api-key), adicional generamos el hash "HMAC" con el algoritmo sha256 La data enviada sera enviada en formato **JSON**. Si la aplicacion no responde con un estado **2xx** se reintentara el llamado 10s despues, si tambien falla se reitentara despues de 100s, despues de este ultimo no habran mas intentos. ::: ## Webhook [#webhook] El objeto retornado de webhook transacción esta compuesto por dos partes: - **transaction** que tendra la información relacionada a la transacción realizada - **checkout** que tendra la información relacionada a la herramienta de cobra plus, así como datos relacionados al formulario de cobra plus ```json { "transaction": { "transaction_id": 143, "amount": 100000, "currency_type": "COP", "value_cop": 100000, "payment_method": "credit", "payment_method_source": "Mastercard", "trazability_id": 143, "transaction_details": { "name": "PRUEBA TARJETA", "identification_type": "CC", "identification_number": "100646164564", "email": "email@gmail.com", "country": "+57", "phone": "3007691450", "number_card": "524931******0339", "installments": 1, "franchise": "Mastercard", "status_message": "Runing Mock" }, "status": "Aprobada", "url_response": "https://sag.efipay.co/Checkout/Transaction/9b902174-7189-4f5a-a035-6b68f97b695a/Response", "approved_at": "2024-03-14T16:23:08.790973Z", "production": true, "created_at": "2024-03-14 11:23:08", "customer_payer": { "id": "9b8fd2c5-b813-4fdd-8881-a4d0c5db3e89", "name": "Nombre Apellido", "email": "email@gmail.com", "created_at": "2024-03-14 07:43:08", "updated_at": "2024-03-14 07:43:08" }, "currency_rate_conversion": { "id": 1, "usd_to_cop": 0.000256, "eur_to_cop": 0.000233, "active": 1, "created_at": "2023-12-22T21:10:45.000000Z", "updated_at": "2023-12-22T21:10:45.000000Z", "deleted_at": null }, "description": "Runing Mock" }, "checkout": { "id": "9b902174-5ce8-4ad9-aba4-66776ec37f87", "payment_referenceable_type": "App\\Models\\CollectionTools\\CobraPlus\\CobraPlusPaymentReference", "payment_referenceable_id": "6", "payment_gateway_id": "9b57ffaf-5524-4184-ac61-3b04087a39cf", "delivery_address_id": null, "commerce_id": 1, "office_id": 1, "comments": null, "total_advance": 100000, "paid_at": "2024-03-14 11:23:08", "ongoing_transaction": 0, "customer_payer_id": "9b8fd2c5-b813-4fdd-8881-a4d0c5db3e89", "created_at": "2024-03-14 11:23:08", "updated_at": "2024-03-14 11:23:08", "total_pending": 0, "payment_gateway": { "id": "9b57ffaf-5524-4184-ac61-3b04087a39cf", "gatewayable_type": "App\\Models\\CollectionTools\\CobraPlus\\CobraPlus", "gatewayable_id": "9b57ffaf-126c-42d7-b99a-5436c6c7a469", "advanced_option_id": null, "created_user_id": 11, "updated_user_id": 11, "office_id": 1, "commerce_id": 1, "massive_upload_id": null, "url": "https://sag.efipay.co/Checkout/PaymentGateway/9b57ffaf-5524-4184-ac61-3b04087a39cf?signature=36e7f02f58c57167fec158375a866e99e0216f253e494d37cb7947c738369fb8", "full_payment_at": null, "active": 1, "production": 1, "created_at": "2024-02-15 13:42:21", "updated_at": "2024-02-15 14:58:04", "deleted_at": null, "sub_total": null, "amount_without_tax": null, "tax_amount": null, "total": null, "total_cop": null, "tool_name": "CobraPlus", "gatewayable": { "id": "9b57ffaf-126c-42d7-b99a-5436c6c7a469", "description": "Prueba Multipago", "charge_type": "Multipago", "amount": null, "tax": null, "currency_type": null, "payments_maked": 6, "created_at": "2024-02-15 13:42:21", "updated_at": "2024-03-14 11:23:08", "deleted_at": null, "total": null, "include_tax": false, "tax_amount": 0 }, "advanced_option": null }, "payment_referenceable": { "id": 6, "cobra_plus_id": "9b57ffaf-126c-42d7-b99a-5436c6c7a469", "description": "Hola", "amount": 100000, "tax": 0, "currency_type": { "name": "Peso Colombiano", "symbol": "$", "abbreviation": "COP" }, "advanced_option_id": "9b9013af-c101-4b61-bb20-5151d14e3e30", "created_at": "2024-02-15 13:42:21", "updated_at": "2024-03-14 10:44:38", "deleted_at": null, "sub_total": 100000, "amount_without_tax": 100000, "tax_amount": null, "total": 100000, "total_cop": 100000, "include_tax": false, "purchase_detail": { "amount": 100000, "discount": null, "tax": null, "sub_total": 100000, "delivery": null, "total": 100000 }, "advanced_option": { "id": "9b9013af-c101-4b61-bb20-5151d14e3e30", "limit_date": null, "references": [], "result_urls": { "webhook": "http://yourdoamin.com/api/webhook" }, "delivery_service_type": null, "delivery_service_value": null, "request_address_delivery": false, "payment_methods": [], "discount_before_on": null, "discount_type": null, "discount_value": null, "has_comments": false, "comments_label": null, "limit_payments": null, "created_at": "2024-03-14 10:44:38", "updated_at": "2024-03-14 10:44:38", "deleted_at": null, "url_picture": null, "has_delivery_service": false, "has_all_payment_methods": true, "has_discount_early_payment": false, "has_limit_payments": false } }, "paid_advance": { "id": "9b902174-77e4-4887-bba9-82a546e45d86", "description": "Prueba Multipago", "amount_paid": 100000, "amount_currency": { "name": "Peso Colombiano", "symbol": "$", "abbreviation": "COP" }, "exchange_paid": 100000, "exchange_currency": "COP", "tool_paid": true, "checkout_gateway_id": "9b902174-5ce8-4ad9-aba4-66776ec37f87", "transaction_id": "9b902174-7189-4f5a-a035-6b68f97b695a", "created_at": "2024-03-14T16:23:08.000000Z", "updated_at": "2024-03-14T16:23:08.000000Z", "deleted_at": null }, "answer_form": { "id": 24, "form_maker_id": 6, "checkout_gateway_id": "9b902174-5ce8-4ad9-aba4-66776ec37f87", "created_at": "2024-03-14T16:23:08.000000Z", "updated_at": "2024-03-14T16:23:08.000000Z", "deleted_at": null, "answer_fields": [ { "id": 33, "answer_form_id": 24, "form_field_id": 6, "answer": "La Respuesta", "created_at": "2024-03-14T16:23:08.000000Z", "updated_at": "2024-03-14T16:23:08.000000Z", "deleted_at": null, "form_field": { "id": 6, "form_maker_id": 6, "label": "Pregunta", "type": "text", "additional_configuration": [], "required": 0, "reference": null, "order": 1, "created_at": "2024-02-16 19:42:21", "updated_at": "2024-02-16 19:42:21", "deleted_at": null } } ] } } } ```