Missing documentation for payment reference attribute

[jhakkinen]

Apparently the reference attribute for payments created via the /payments endpoint must be a valid Finnish bank reference (pankkiviite) if per-transaction settlement (individual settlement) is used. This is not mentioned in the docs where it just says that reference should be a string of max 200 characters.

If per-transaction settlement is active and the submitted reference is not a valid bank reference, the Paytrail API will respond with "Given reference did not pass Finnish reference number validation".

This constraint for the reference attribute should be mentioned in the docs.

[marcusksm]

Hi!

You’re absolutely right!

This behaviour is expected when per-transaction settlement is used, and the reference must be a valid Finnish bank reference in those cases. We’ll update the documentation to clarify this requirement.

Thanks for pointing this out!