Lister les décaissements
La liste des décaissements (cashouts) d'une marketplace est consultable sur la ressource :
Les résultats sont retournés sous la forme:
{ "count": 3, "next": null, "previous": null, "results": [ { "href": "/marketplace/v1/cashouts/749e668e-526d-41ec-8e7c-e5afc3d89ddc", "uuid": "749e668e-526d-41ec-8e7c-e5afc3d89ddc", "seller": "b646ea68-a145-4a5a-8a6f-55e8f68643dd", "seller_external_ref": "ref039412", "ref": "demoeYDPnZuC", "status": "CREATED", "amount": 1900, "currency": "EUR", "captured_at": "2019-04-04", "capture_label": "MYMKPSLR1012324" }, { "href": "/marketplace/v1/cashouts/b92d904a-8613-4368-98b7-96d75a623d97", "uuid": "b92d904a-8613-4368-98b7-96d75a623d97", "seller": "f8dcc611-bbaa-411a-8f28-ea2d6e4f49a8", "seller_external_ref": "ref09523", "ref": "demoeYDPnZuC", "status": "CREATED", "amount": 1900, "currency": "EUR", "captured_at": "2019-03-03", "capture_label":"MYMKPSLR1012325" }, { "href": "/marketplace/v1/cashouts/f9132b0b-8d42-4409-b3e1-c1c6d711688b", "uuid": "f9132b0b-8d42-4409-b3e1-c1c6d711688b", "seller":"4d20a9d4-0526-4474-b452-e936dc25418d", "seller_external_ref": "ref012345", "ref": "demoeYDPnZuC", "status": "CREATED", "amount": 1450, "currency": "EUR", "captured_at": "2019-01-01", "capture_label": "MYMKPSLR1012326" } ] }
Ces résultats sont triés par date de capture descendante (attribut captured_at).
Ils sont paginés à raison de 100 cashouts par page.
Les liens "next" et "previous", quand ils sont valorisés, permettent de naviguer d'une page à une autre.
Il est également possible de filtrer les résultats de cette liste par leur date de capture.
Pour ce faire, il faut spécifier les paramètres capture_start_date et/ou capture_end_date de la façon suivante :
GET https://.../marketplace/v1/cashouts/?capture_start_date=2019-02-01&capture_end_date=2019-03-31
GET https://.../marketplace/v1/cashouts/?capture_start_date=2019-02-01
GET https://.../marketplace/v1/cashouts/?capture_end_date=2019-01-01
Si le paramètre capture_start_date est renseigné mais pas capture_end_date, celui-ci est fixé à la date du jour (« aujourd'hui »).
Si à l'inverse, le paramètre capture_start_date est omis mais que capture_end_date est précisé, la sélection prendra les cashouts depuis le début jusqu'à la date donnée.