[Feature]: Parser for Webhook Payload `NotificationRequestItem`

[obber]

Feature summary

Add a parser that returns a typed contract for NotificationRequestItem

Problem statement

Reference: https://github.com/Adyen/adyen-go-api-library/blob/de7104ad348dde59c0eed4c0456a6e43222d079a/src/webhook/model_notification_request_item.go#L6C2-L6C16

Currently, the NotificationRequestItem is a *map[string]interface{}. This makes it difficult to consume the webhook events that send this payload.

It would be great to have a parser that gives us a typed contract for NotificationRequestItem that we use in our webhook event handler.

Proposed solution

A library or package that parses the map of arbitrary fields and exposes a typed contract for additionalDetails (The NotificationRequestItem)

Alternatives considered

Update the types directly in the go sdk but that will probably be a big breaking change for a bunch of clients, so a parser would make more sense?

Additional context

We surface things like the last 4-digits and a card icon on our payment confirmation page, which we get from the AUTHORISED webhook event. We'd prefer to use a typed contract to understand and use these values.

[gcatanese]

Thank you @obber for reporting this. We understand the limitation of the library here, unfortunately we have the same in all libraries.
We are investigating the options to create static types for the additionalData information, as part of the code generation from the OpenAPI spec file.
But we also want to redefine the additionalData to make sure it is relevant to the specific webhook event, at the moment we include all fields for all possible events. A discussion has started already.

[mmosky]

Another problem, omitEmpty is an invalid tag. The correct tag is omitempty.

The test will fail.

func TestOmitEmpty(t *testing.T) {
	var v struct {
		M *map[string]interface{} `json:"m,omitEmpty"`
	}
	b, err := json.Marshal(v)
	if err != nil || string(b) != "{}" {
		t.Fatalf("json.Marshal(v) failed, err: %v, b: %s", err, string(b))
	}
}