# Submit a complaint

There can be situations where a buyer isn't happy with the transaction. In these situations, the buyer can submit a complaint. Complaints can be registered after handover.

```CURL Create a complaint for a transaction
curl -i -X POST \
-u '<API_KEY>:' \
'https://api.test.trustap.com/v2/transactions/tx_01kr3khqk9fjf9scvqfpzkxew4/submit_complaint' \
-H 'Content-Type: application/json' \
-H 'Trustap-User: 1-def29dfe-8626-48a2-8863-b6fdf2b96ff0' \
-d '{
"description": "Wrong colour"
}'
```

```JSON Response
{
"buyer": {
"id": "1-def29dfe-8626-48a2-8863-b6fdf2b96ff0",
"is_guest": true
},
"client_id": "5ad5451d-70c7-43c6-86c9-e1d90556856c",
"complaint": {
"description": "Wrong colour"
},
"deadlines": {
"complaints": "2026-05-09T10:56:22Z"
},
"description": "Trustap socks",
"events": {
"by_key": {
	"complaint_submitted": "2026-05-08T10:56:32Z",
	"created": "2026-05-08T10:53:47Z",
	"joined": "2026-05-08T10:53:47Z",
	"paid": "2026-05-08T10:54:45Z",
	"payment_accepted": "2026-05-08T10:55:11Z",
	"seller_handover_confirmed": "2026-05-08T10:56:22Z"
},
"by_time": [
	{
		"at": "2026-05-08T10:53:47Z",
		"code": "created"
	},
	{
		"at": "2026-05-08T10:53:47Z",
		"code": "joined"
	},
	{
		"at": "2026-05-08T10:54:45Z",
		"by": "1-def29dfe-8626-48a2-8863-b6fdf2b96ff0",
		"code": "paid"
	},
	{
		"at": "2026-05-08T10:55:11Z",
		"by": "1-de4eff1e-8039-48ce-b37d-3086a9a1cdc5",
		"code": "payment_accepted"
	},
	{
		"at": "2026-05-08T10:56:32Z",
		"by": "1-def29dfe-8626-48a2-8863-b6fdf2b96ff0",
		"code": "complaint_submitted"
	},
	{
		"at": "2026-05-08T10:56:22Z",
		"by": "1-de4eff1e-8039-48ce-b37d-3086a9a1cdc5",
		"code": "seller_handover_confirmed"
	}
]
},
"id": "tx_01kr3khqk9fjf9scvqfpzkxew4",
"pricing": {
"amount": 20000,
"amount_extra": 0,
"currency": "gbp",
"fees": {
	"buyer": 640,
	"buyer_client": 0,
	"international_payment": 310,
	"seller": 0,
	"seller_client": 0
}
},
"seller": {
"id": "1-de4eff1e-8039-48ce-b37d-3086a9a1cdc5",
"is_guest": true
},
"status": "complaint_submitted"
}
```

Creating a complaint automatically sends an email to the buyer and seller with instructions to resolve the conflict.

Sample buyer complaint email
![](/assets/sample-buyer-complaint-email.6688040a0b79e2a456ce1f3b6f122747aca17047e8172ed7dbcc6cd3a45f95a4.3b378a3f.png)

Sample seller complaint email
![](/assets/sample-seller-complaint-email.580ba3d54fc1ae074b6287ee36a3f77a49a32fa7250579ade47b3ca48902692b.3b378a3f.png)