Idempotency

MEO Wallet offers this special feature which can be used to track your request if you pass a “request_id” in your payload. This is available on these API’s: checkout, payment, authorization (including captures/releases) and refund.

This is useful:

1. If you get an error from our API and you didn’t know what happened with the request.
2. If you want to get the same information (namely the same checkout id) when your customer initiates a payment of the same purchase multiple times in your online store.

You must generate an UUID (unique for each Wallet) to have a unique request. If you send the same “request_id” twice you will get the same data.

Below, there is an example of a call to the endpoint which you can use to get the status of a given request. You need to send a HTTP “Authorization” header. Check the Authentication section for details.

In the example below (from the sandbox environment), an operation id was returned.

curl -X GET https://services.sandbox.meowallet.pt/api/v2/requests/<<uuid>> \
  -H "Content-Type: application/json" \
  -H "Authorization: WalletPT <<merchant-api-key>>" \

Response:

{
    "href": "https://services.sandbox.meowallet.pt/api/v2/operations/187bbe10-1bf1-11ee-b953-7ab6f5cf2760",
    "status": "COMPLETED",
    "method": "GET"
}