feat(core): add decorator for reponse http status 402 : ApiPaymentRequiredResponse

[mgohin]

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://github.com/nestjs/nest/blob/master/CONTRIBUTING.md
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

• Bugfix
• Feature
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no api changes)
• Build related changes
• CI related changes
• Other... Please describe:

What is the current behavior?

No decorator to add documentation about response with HTTP status 402 Payment required

Issue Number: N/A

What is the new behavior?

Added the decorator @ApiPaymentRequiredResponse

Does this PR introduce a breaking change?

• Yes
• No

Other information

[kamilmysliwiec]

LGTM