Resend Webhook

This API creates a webhook resend request for cash-in (QR Code) or cash-out (Transaction) events. You can resend specific webhooks by object ID or perform a bulk resend for all webhooks within a specified time period for an account.

POSThttps://api.socredsa.com.br/v3/webhooks/resend

curl --request POST \
  --url 'https://api.socredsa.com.br/v3/webhooks/resend' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
  "resend_type": "CASHIN",
  "object_reference_id": 12345
}'

Response200

{
  "worked": true,
  "detail": "Webhook resend request created. ID: 7890"
}

Endpoint

POST /v3/webhooks/resend

Send all dates and times in UTC-0. Date-times must use ISO 8601 with the Z suffix (YYYY-MM-DDTHH:MM:SSZ, e.g., 2026-05-01T00:00:00Z). Do not send local time or timezone offsets such as -03:00.

Headers

Parameter	Type	Description	Example
Authorization	String	Bearer + Access_token	Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzEzMzAwOTMxLCJpYXQiOjE3MTMyOTczMzEsImp0aSI6Ijc2ZWI4ZTE5ZjM4YjQ4NmZiODdmNzNjNTdkMWVmNDJhIiwidXNlcl9pZCI6MjQ2fQ.5zekMa7CUj9p-MvNHns5ke4ZPhYV3Y1CLOsYL7hDUUo

Body Details

{
  "resend_type": "CASHIN",
  "object_reference_id": 12345,
  "source_account_branch_identifier": "0001",
  "source_account_number": "123456",
  "start_datetime": "2026-05-01T00:00:00Z",
  "end_datetime": "2026-05-12T23:59:59Z"
}

Field	Type	Description	Required or Optional
resend_type	String	Type of webhook to resend. Valid values: `CASHIN` (for QR Code) or `CASHOUT` (for Transaction).	required
object_reference_id	Integer	ID of the specific object to resend webhook for. For CASHIN: QR Code ID. For CASHOUT: Transaction ID.	optional
source_account_branch_identifier	String	Branch identifier of the source account. Required when using date range filters (`start_datetime`/`end_datetime`).	optional
source_account_number	String	Account number of the source account. Required when using date range filters (`start_datetime`/`end_datetime`).	optional
start_datetime	DateTime	Start date and time for bulk resend (ISO 8601 in UTC-0, with the `Z` suffix). Requires account identification.	optional
end_datetime	DateTime	End date and time for bulk resend (ISO 8601 in UTC-0, with the `Z` suffix). Requires account identification.	optional

Request Examples

Resend webhook for a specific QR Code (CASHIN):

POST /v3/webhooks/resend
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "resend_type": "CASHIN",
  "object_reference_id": 12345
}

Resend webhook for a specific Transaction (CASHOUT):

POST /v3/webhooks/resend
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "resend_type": "CASHOUT",
  "object_reference_id": 98765
}

Bulk resend webhooks for a source account in a date range:

POST /v3/webhooks/resend
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "resend_type": "CASHIN",
  "source_account_branch_identifier": "0001",
  "source_account_number": "123456",
  "start_datetime": "2026-05-01T00:00:00Z",
  "end_datetime": "2026-05-12T23:59:59Z"
}

Response Details

{
  "worked": true,
  "detail": "Webhook resend request created. ID: 7890"
}

Field	Type	Description
worked	Boolean	`true` when the resend request was successfully created, `false` on error.
detail	String	Success message with the resend log ID, or error description when failed.

Error Responses

HTTP Code	Error Message	Description
400	QR Code not found	The specified QR Code ID does not exist or you do not have access to it.
400	Transaction not found	The specified Transaction ID does not exist or you do not have access to it.
400	Account not found	The account identified by branch and account number was not found or is not accessible.
401	Unauthorized	Invalid or missing authentication token. Ensure you are sending a valid Bearer token.
422	Validation error	Request validation failed. Check that all required fields are present and in the correct format.

Business Rules

Authentication:

Requires valid authentication token
User must be authenticated

Resend Modes:

Resend webhook for a specific object by providing object_reference_id
Perform bulk resend by providing date range (start_datetime and end_datetime) along with account identification
When using date range filters, both source_account_branch_identifier and source_account_number are required

Validations:

For CASHIN type: Must provide either object_reference_id or all date range parameters
For CASHOUT type: Must provide either object_reference_id or all date range parameters
You can only resend webhooks for objects and accounts that you have access to
Date range requires all four fields: branch identifier, account number, start datetime, and end datetime

Processing:

The resend request is processed asynchronously in the background
The response returns immediately with a request ID
Use the List Webhook Resend Logs endpoint to check the processing status

curl --request POST \
  --url 'https://api.socredsa.com.br/v3/webhooks/resend' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
  "resend_type": "CASHIN",
  "object_reference_id": 12345
}'

Response200

{
  "worked": true,
  "detail": "Webhook resend request created. ID: 7890"
}