{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/v:version/donations.json","auth":"required","results":{"codes":[{"status":201,"language":"json","code":"{\n    \"id\":1259,\n    \"ident_id\":1050,\n    \"transaction_id\":\"\",\n    \"fb_transaction_id\":null,\n    \"fb_person_id\":501,\n    \"fb_payment_form_configuration_id\":null,\n    \"fb_payout_id\":null,\n    \"fb_source_id\":null,\n    \"source_name\":\"\",\n    \"source_promotion_code\":\"\",\n    \"fb_project_id\":null,\n    \"project_promotion_code\":\"\",\n    \"fb_type_id\":8,\n    \"type_promotion_code\":\"\",\n    \"fb_person_bank_account_id\":null,\n    \"fb_person_credit_card_id\":null,\n    \"fb_sepa_mandate_id\":724,\n    \"amount\":123,\n    \"currency\":\"EUR\",\n    \"info\":\"\",\n    \"receipt_status\":\"receipt_now\",\n    \"public_name\":\"John Doe\",\n    \"public_message\":\"Yeah!\",\n    \"fb_fundraising_page_id\":null,\n    \"status\":\"confirmed\",\n    \"device_type\":\"unknown\",\n    \"created_at\":\"2019-03-20 00:00:00\",\n    \"updated_at\":\"2019-04-24 13:39:46\",\n    \"received_at\":null,\n    \"fb_custom_fields\":[]\n}","name":""}]},"settings":"","examples":{"codes":[{"language":"json","code":"{\n    \"fb_person_id\":501,\n    \"fb_type_id\":8,\n    \"fb_sepa_mandate_id\":724,\n    \"amount\":123,\n    \"receipt_status\":\"receipt_now\",\n    \"public_name\":\"John Doe\",\n    \"public_message\":\"Yeah!\",\n    \"created_at\":\"2019-03-20 00:00:00\",\n    \"received_at\":null\n}"}]},"method":"post","params":[]},"next":{"description":"","pages":[]},"title":"/donations.json","type":"endpoint","slug":"donations-create","excerpt":"Creates a new donation.","body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Field\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Type\",\n    \"h-3\": \"Mandatory\",\n    \"0-0\": \"fb_person_id\",\n    \"1-0\": \"fb_source_id\",\n    \"2-0\": \"fb_project_id\",\n    \"3-0\": \"fb_type_id\",\n    \"4-0\": \"fb_person_bank_account_id\",\n    \"5-0\": \"fb_person_credit_card_id\",\n    \"6-0\": \"fb_sepa_mandate_id\",\n    \"7-0\": \"amount\",\n    \"8-0\": \"info\",\n    \"9-0\": \"receipt_status\",\n    \"10-0\": \"public_name\",\n    \"11-0\": \"public_message\",\n    \"12-0\": \"fb_fundraising_page_id\",\n    \"13-0\": \"received_at\",\n    \"14-0\": \"created_at\",\n    \"0-2\": \"integer\",\n    \"1-2\": \"integer\",\n    \"2-2\": \"integer\",\n    \"3-2\": \"integer\",\n    \"4-2\": \"integer\",\n    \"5-2\": \"integer\",\n    \"6-2\": \"integer\",\n    \"7-2\": \"float\",\n    \"12-2\": \"integer\",\n    \"9-2\": \"Enum (\\\"receipt_now\\\", \\\"no_receipt\\\", \\\"receipt_end_of_year\\\", \\\"receipt_sent\\\", \\\"receipt_never\\\")\",\n    \"8-2\": \"string (500)\",\n    \"10-2\": \"string (100)\",\n    \"11-2\": \"string (1000)\",\n    \"14-2\": \"datetime\",\n    \"13-2\": \"datetime\",\n    \"0-1\": \"ID of a [person](doc:persons-list)\",\n    \"1-1\": \"ID of a [source](doc:sources-list)\",\n    \"2-1\": \"ID of a [project](doc:projects-list)\",\n    \"3-1\": \"ID of a [payment type](doc:types-list)\",\n    \"6-1\": \"ID of a [mandates](doc:mandates-list)\",\n    \"12-1\": \"ID of a [fundraising page](doc:pages-list)\",\n    \"4-1\": \"ID of a [bank account](doc:personBankAccounts-show)\",\n    \"5-1\": \"ID of a [credit card](doc:personCreditCard-show)\",\n    \"7-1\": \"The amount\",\n    \"8-1\": \"A message from the donor\",\n    \"9-1\": \"Status of the donation receipt wish\",\n    \"10-1\": \"A public name of the donor\",\n    \"11-1\": \"A public message from the donor\",\n    \"13-1\": \"Timestamp when the money of the donotion was received\",\n    \"14-1\": \"Timestamp when the donation was created\",\n    \"7-3\": \"yes\",\n    \"14-3\": \"yes\",\n    \"3-3\": \"yes\"\n  },\n  \"cols\": 4,\n  \"rows\": 15\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Please find further information about custom fields [at the custom fields section](doc:custom-fields).\",\n  \"title\": \"Custom fields\"\n}\n[/block]","updates":[],"order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5cc04b4a49f32f001f1a0604","project":"571f5e8cd8667f0e00a3c498","version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["571f5e8cd8667f0e00a3c49c","571f73cfcb4baa0e00d13a80","571f7451cb4baa0e00d13a88","571f7d2720695f3400f38797","571f7fb0ac2a080e0014c661","571f884be54f2d0e003ebb0a","572200c9ecb38d0e00d80ebd","572c301e7c8eff0e00aaa174","57df91b2c6348d0e0020c452","57e104db9ff1e21900a721ab","57fd04caeaa77f19008b8202","5899c7113514ce0f0014da84","5cbeda4b862d090013abd413","5e60d6278f8b380072f0b1e3"],"_id":"571f5e8cd8667f0e00a3c49b","hasDoc":true,"releaseDate":"2016-04-26T12:26:52.312Z","__v":14,"hasReference":true,"createdAt":"2016-04-26T12:26:52.312Z","project":"571f5e8cd8667f0e00a3c498"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"JSON-REST-API (API-Package)","slug":"rest-api-json","order":9,"from_sync":false,"reference":false,"_id":"5cbeda4b862d090013abd413","project":"571f5e8cd8667f0e00a3c498","version":"571f5e8cd8667f0e00a3c49b","createdAt":"2019-04-23T09:26:35.210Z","__v":1},"user":"5720ba18c669e80e00c35051","createdAt":"2019-04-24T11:40:58.273Z","__v":0,"parentDoc":null}

post/donations.json

Creates a new donation.

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format


Documentation

[block:parameters] { "data": { "h-0": "Field", "h-1": "Description", "h-2": "Type", "h-3": "Mandatory", "0-0": "fb_person_id", "1-0": "fb_source_id", "2-0": "fb_project_id", "3-0": "fb_type_id", "4-0": "fb_person_bank_account_id", "5-0": "fb_person_credit_card_id", "6-0": "fb_sepa_mandate_id", "7-0": "amount", "8-0": "info", "9-0": "receipt_status", "10-0": "public_name", "11-0": "public_message", "12-0": "fb_fundraising_page_id", "13-0": "received_at", "14-0": "created_at", "0-2": "integer", "1-2": "integer", "2-2": "integer", "3-2": "integer", "4-2": "integer", "5-2": "integer", "6-2": "integer", "7-2": "float", "12-2": "integer", "9-2": "Enum (\"receipt_now\", \"no_receipt\", \"receipt_end_of_year\", \"receipt_sent\", \"receipt_never\")", "8-2": "string (500)", "10-2": "string (100)", "11-2": "string (1000)", "14-2": "datetime", "13-2": "datetime", "0-1": "ID of a [person](doc:persons-list)", "1-1": "ID of a [source](doc:sources-list)", "2-1": "ID of a [project](doc:projects-list)", "3-1": "ID of a [payment type](doc:types-list)", "6-1": "ID of a [mandates](doc:mandates-list)", "12-1": "ID of a [fundraising page](doc:pages-list)", "4-1": "ID of a [bank account](doc:personBankAccounts-show)", "5-1": "ID of a [credit card](doc:personCreditCard-show)", "7-1": "The amount", "8-1": "A message from the donor", "9-1": "Status of the donation receipt wish", "10-1": "A public name of the donor", "11-1": "A public message from the donor", "13-1": "Timestamp when the money of the donotion was received", "14-1": "Timestamp when the donation was created", "7-3": "yes", "14-3": "yes", "3-3": "yes" }, "cols": 4, "rows": 15 } [/block] [block:callout] { "type": "info", "body": "Please find further information about custom fields [at the custom fields section](doc:custom-fields).", "title": "Custom fields" } [/block]

User Information

Try It Out

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