Webhooks Reference¶

Autocore sends webhook notifications as POST requests to the URL specified in temp_webhook_url.

The webhook is considered successfully delivered only if the endpoint responds with HTTP 200. Any other response triggers a retry every 30 minutes.

Payload Structure¶

{
  "payment_status": "Aplicado",
  "amount": 750,
  "payment_date": "2026-01-28T19:30:16.390834",
  "company": "Company Name",
  "hotel": "Hotel Name",
  "voucher_url": "https://api.autocore.pro/v2/terminal-payments/xxx/vouchers",
  "transaction_id": "RB-827814",
  "external_ref_id": "your-reference-id",
  "details": {
    "type": "charge",
    "id": "vpdrj2l5xo4y",
    "external_ref_id": "your-reference-id",
    "status_code": "applied",
    "status_detail": "Aplicado",
    "comments": "Pago procesado correctamente",
    "transaction_id": "RB-827814",
    "transaction_date": "2026-01-28T19:30:16.390834"
  }
}

Payload Fields¶

Field	Type	Description
`payment_status`	String	Status in Spanish: `Aplicado`, `Rechazado`, `En proceso`
`amount`	Number	Transaction amount
`payment_date`	String	ISO 8601 timestamp
`company`	String	Company name
`hotel`	String	Hotel name
`voucher_url`	String	URL to download the payment voucher
`transaction_id`	String	Unique transaction ID (`N/A` if rejected)
`external_ref_id`	String	Your reference ID from the original request
`details`	Object	Detailed payment status information

Products That Send Webhooks¶

Product	Trigger	URL Parameter
Direct Charge	Payment status change	`order.temp_webhook_url`
Payment Links	Payment completed/failed	`temp_webhook_url`

Best Practices

Your webhook endpoint must accept POST requests and return 200.
Always verify details.status_code for the authoritative payment status.
Use external_ref_id to match notifications with your internal records.
Implement idempotency --- you may receive the same webhook more than once.