Resend Webhook

POST https://api.somossimpay.com.br/v3/webhooks/resend

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.

Headers

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

Body Details

Body JSON (Raw)

{
  "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 format). Requires account identification.	optional
end_datetime	DateTime	End date and time for bulk resend (ISO 8601 format). Requires account identification.	optional

Request Examples

Resend webhook for a specific QR Code (CASHIN):

HTTP

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):

HTTP

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:

HTTP

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

Response

{
  "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