Create a refund link

post

https://api.djfindr.com/prod/v1/me/payments/received/{id}/refund-link

Get a link to refund a payment I received. Needs payments:write. Answers 201 with the link: send its url to the person as it is. They open it, sign in to DJfindr as themself (their session, or a code to their email) and confirm there; the API never does it. No Idempotency-Key is needed (one sent is ignored): making the same link again replaces this app's older live one for the same record. Answered with Cache-Control: no-store: the URL carries the link's token, so treat it as a secret until expires_at. The body is the input as JSON; where it takes expected_updated_at, send the updated_at you read and a stale edit is 412.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201The link, made now

400The body is not a JSON object

401Missing, invalid or expired access token

403The token does not hold payments:write, the account may not do this, or an API key was sent (oauth_required), or a DJ's third-party app without the Platinum plan was used (plan_required)

404Not found: no such record of mine (another person's id included)

422Some of the input is not valid, or a query parameter this request does not take was sent; fields names each

429Rate limited (also 30 links an hour per person, 10 an hour per person and record); see Retry-After

503Temporarily unavailable; safe to retry