shops.transferAccept

Accept a hand-off and become the shop's owner (the person asked, on a hosted page). The person agrees to the Terms of Service by ticking a box (accept_terms_version); the record keeps the version, time, IP address and browser. Comes back with status expired when the 14 days ran out. Every sent invoice nobody has paid yet is voided and reissued as a draft with the same lines (invoices_reissued), so it pays into your payments account once you finish payment setup and send it. Customers are not emailed. Partly paid invoices, ones with a payment going through and ones with a card checkout open stay as they are and collect on your account once it is set up (invoices_kept).

When to use it

Accept a hand-off and become the shop's owner (the person asked, on a hosted page). The person agrees to the Terms of Service by ticking a box (accept_terms_version); the record keeps the version, time, IP address and browser.

What to tell the owner

Send the person the link. They finish this step themselves on the page; you never do it for them.

Input

Example

POST https://doingwork.work/v1/shops/transfers/accept
content-type: application/json
Idempotency-Key: 3f1c...

{
  "transfer_id": "00000000-0000-4000-8000-000000000000",
  "accept_terms_version": "..."
}

Output

{
  "transfer_id": "00000000-0000-4000-8000-000000000000",
  "shop_id": "00000000-0000-4000-8000-000000000000",
  "shop": "...",
  "from_person_id": "00000000-0000-4000-8000-000000000000",
  "from_name": "...",
  "to_person_id": "00000000-0000-4000-8000-000000000000",
  "to_name": "...",
  "status": "...",
  "old_owner_stays_as_office": true,
  "started_at": "...",
  "expires_at": "...",
  "completed_at": "...",
  "cancelled_at": "...",
  "processor_reverify_status": "...",
  "you_are": "...",
  "invoices_reissued": [
    {
      "voided_invoice_id": "00000000-0000-4000-8000-000000000000",
      "new_invoice_id": "00000000-0000-4000-8000-000000000000",
      "total_minor": 50000
    }
  ],
  "invoices_kept": [
    {
      "invoice_id": "00000000-0000-4000-8000-000000000000",
      "reason": "..."
    }
  ]
}

Errors