status url missing in Docs

[thijnmens]

the following typescript code will complain about "status" not being valid

const mollieClient = createMollieClient({apiKey: process.env.MOLLIE_KEY as string});
const payment = await mollieClient.payments.get(payment_id);

console.log(payment._links.status) // TS2339: Property status does not exist on type PaymentLinks

console.log(payment._links) // { ... status: { href: "...", type: 'text/html' } ... }

After checking, the type PaymentLinks indeed does not include status

[janpaepke]

The status property does not exist on type PaymentLinks because as far as I know the status property does indeed not exist on type PaymentLinks.

I checked again to see if one was added but there is no status in the _links response property.

Could you point me to the documentation that lead you to believe otherwise?

What exactly are you trying to achieve?
Do you maybe want the dashboard link to the payment?
This is available via payment.getDashboardUrl().

[thijnmens]

When i print my _links object, it does have a status object. Here is a screenshot of the print with some information cut out because i don't know if it contains sensitive information or not.

I've tested it with 2 transaction types. The status property does not exist on iDEAL transactions, but it does on the SEPA bank transfer. I believe the documentation is also outdated in this case (although i have no idea why, how, or if there is maybe a different page where it is mentioned)

The thing I'm trying to do is to give my customers a link with which they can go back to the payment screen in case they need to for whatever reason (for the bank transfer for example, they can check the status of it). Is there another way to do this that would also work for iDeal that you know of then?

[janpaepke]

I looked into this some more and you are indeed correct. I didn't know about this link param because I have personally never used it and it seems to be non-existent in the docs.

The correct way to access it is using the URL helper: payment.getStatusUrl() (see here).

Read here for an explanation why _links, like _embed is considered private and should not be accessed directly.

This still leaves us with the fact, that this does not appear anywhere in the API documentation. I might have expected it in the method specific parameters, but couldn't find it there either.

@fjbender could you shed some light?
Are there docs for _links.status somehwere or are they missing?

[thijnmens]

I must've missed this method when searching for another way to get the status! I'll use that instead then, thank you.

[fjbender]

For banktransfer payments we have two method-specific _links properties:

1. status which is a consumer-facing page in case they want to know whether their payment has been received yet and
2. payOnline which provides consumers with a hosted payment page to choose a quicker method to pay than legacy bank transfoer, which can also be provided to consumers at the merchant's discretion

I'll add both of them to the documentation soon.

[janpaepke]

I have confirmed that both these URLs are already available through the client:

• status: payment. getStatusUrl()
• payOnline: payment.getPayOnlineUrl()

This means there is no TODO for the package.
We will keep this issue open until the Api-Docs are updated.