Update payment methods

[janpaepke]

Fixes #357

The reference list is taken from the API docs for the get method.

1. Added the following new payment methods to PaymentMethod:

   • alma
   • bacs
   • bancomatpay
   • billie
   • blik
   • riverty
   • satispay
   • trustly
   • twint

2. Moved outdated payment methods to HistoricPaymentMethod:

   • giropay
   • sofort

[Pimm]

@janpaepke mentioned that this PR Introduces a breaking change, but I'm unsure whether I agree.

The following code compiles before this PR, but not after:

mollieClient.payments.create({
  method: PaymentMethod.giropay,
  …
});

Existing code no longer compiler is the tell-tale of a breaking change.

However, while the code above does compile before this PR, it doesn't work anyway, as Giropay has been deprecated.

I am currently on the fence whether this change ‒ and similar future changes ‒ should be considered "breaking" and thus warrant a major version bump.

[janpaepke]

It was not marked as deprecated in the code and thus a consumer could potentially be unaware.

Also using the enum in create isn't the only usecase. Another likely example is a comparison check which will not cause a problem until this PR is merged.

Imho in this particular example it's pretty clear that this should be considered "breaking".

[Pimm]

Another likely example is a comparison check which will not cause a problem until this PR is merged.
That is a valid and compelling argument.

The point that I was trying to make, is that semver is supposed to guarantee that everything continues to function as expected for any non-major update. The second a payment method stops working, existing applications break, even if they don't update this client at all. The semver guarantee doesn't work in that scenario. As such, I am not sure whether it's a bad thing to break the semver rules in such a case.

[janpaepke]

I think I got your point, but as I said, if all they do is checks, the application won't break, because it simply won't receive that payment method anymore...

[Pimm]

Very true, Jan.