{"_id":"5c924fb56594dc014360aa36","project":"571f5e8cd8667f0e00a3c498","version":{"_id":"571f5e8cd8667f0e00a3c49b","hasDoc":true,"__v":13,"hasReference":true,"project":"571f5e8cd8667f0e00a3c498","createdAt":"2016-04-26T12:26:52.312Z","releaseDate":"2016-04-26T12:26:52.312Z","categories":["571f5e8cd8667f0e00a3c49c","571f73cfcb4baa0e00d13a80","571f7451cb4baa0e00d13a88","571f7d2720695f3400f38797","571f7fb0ac2a080e0014c661","571f884be54f2d0e003ebb0a","572200c9ecb38d0e00d80ebd","572c301e7c8eff0e00aaa174","57df91b2c6348d0e0020c452","57e104db9ff1e21900a721ab","57fd04caeaa77f19008b8202","5899c7113514ce0f0014da84","5cbeda4b862d090013abd413"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"category":{"_id":"571f7fb0ac2a080e0014c661","__v":0,"project":"571f5e8cd8667f0e00a3c498","version":"571f5e8cd8667f0e00a3c49b","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-04-26T14:48:16.712Z","from_sync":false,"order":7,"slug":"rest-api","title":"REST-API (XML)"},"user":"5720c075db52d01700f5d1e4","__v":15,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-03-20T14:35:33.646Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"method":"get","examples":{"codes":[{"language":"text","code":""}]},"settings":"","results":{"codes":[{"name":"","code":"<fb_payout>\n  <id type=\"integer\">12345</id>\n  <fb_type_id type=\"integer\">3</fb_type_id>\n  <created_time type=\"datetime\">2019-02-01 15:23:00</created_time>\n  <amount>1234.5</amount>\n  <amount_donations>89.12</amount_donations>\n  <amount_donations_fee>-1.2</amount_donations_fee>\n  <amount_reversed_donations>12.3</amount_reversed_donations>\n  <amount_reversed_donations_fee>0.34</amount_reversed_donations_fee>\n  <amount_unknown>5.6</amount_unknown>\n  <currency>EUR</currency>\n  <external_payout_id>\n  \t<![CDATA[payoutId12345]]>\n  </external_payout_id>\n  <created_at type=\"datetime\">2019-02-21 20:48:11</created_at>\n  <updated_at type=\"datetime\">2019-02-27 09:35:08</updated_at>\n</fb_payout>","language":"xml","status":200}]},"auth":"required","params":[{"_id":"571f829ae54f2d0e003ebadb","ref":"","in":"path","required":true,"desc":"payout id","default":"","type":"int","name":"id"}],"url":"/payouts/:id.xml"},"isReference":true,"order":10,"body":"Field descriptions:\n  * **fb_type_id**: See [Predefined values](doc:predefined-values)\n  * **created_time**: time the payout has been created by the payment provider\n  * **amount**: transferred amount to the bank account\n  * **amount_donations**: sum of the amount of the assigned fb_donations\n  * **amount_donations_fee**: sum of the payment provider fees of the assigend fb_donations (negative number)\n  * **amount_reversed_donations**: sum of the amount of the recognized reversed fb_donations (negative number)\n  * **amount_reversed_donations_fee**: sum of the payment provider fees of the recognized reversed fb_donations (can be negative (e.g. dispute fee) or positive (e.g. refunded fee))\n  * **amount_unknown**: sum of the amount of the unknown transactions found in this payout (not initiated by FundraisingBox)\n  * **currency**: See [Predefined values](doc:predefined-values)\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Retrieve connected fb_donations\",\n  \"body\": \"If you want to retrieve the connected donations to a payout, you can use the [donations-API](doc:donationsxml) with criteria fb_payout_id, for example:\\n**GET /donations.xml?criteria[fb_payout_id]={id}**\"\n}\n[/block]","excerpt":"Returns a single payout.","slug":"payoutsidxml","type":"endpoint","title":"/payouts/:id.xml (BETA)"}

get/payouts/:id.xml (BETA)

Returns a single payout.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
integer
payout id

Result Format


Documentation

Field descriptions: * **fb_type_id**: See [Predefined values](doc:predefined-values) * **created_time**: time the payout has been created by the payment provider * **amount**: transferred amount to the bank account * **amount_donations**: sum of the amount of the assigned fb_donations * **amount_donations_fee**: sum of the payment provider fees of the assigend fb_donations (negative number) * **amount_reversed_donations**: sum of the amount of the recognized reversed fb_donations (negative number) * **amount_reversed_donations_fee**: sum of the payment provider fees of the recognized reversed fb_donations (can be negative (e.g. dispute fee) or positive (e.g. refunded fee)) * **amount_unknown**: sum of the amount of the unknown transactions found in this payout (not initiated by FundraisingBox) * **currency**: See [Predefined values](doc:predefined-values) [block:callout] { "type": "info", "title": "Retrieve connected fb_donations", "body": "If you want to retrieve the connected donations to a payout, you can use the [donations-API](doc:donationsxml) with criteria fb_payout_id, for example:\n**GET /donations.xml?criteria[fb_payout_id]={id}**" } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}