{"_id":"570f2f40986c040e008f7a9a","editedParams":true,"user":"558232f0b806360d0024466d","__v":12,"category":{"_id":"56326e9ddf556c0d00cd08cd","pages":["56326e9edf556c0d00cd08da","56326e9edf556c0d00cd08db","56326e9edf556c0d00cd08dc","56326e9edf556c0d00cd08dd","56326e9edf556c0d00cd08de","56326e9edf556c0d00cd08df","5632e61862c48a0d00334ddc","5637210ec75f5d0d00ec5d4a","563750380704070d00f06c4b","56ecf98c7f94882900591955"],"version":"56326e9cdf556c0d00cd08ca","__v":5,"project":"544fc17e698ab40800b4f891","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-05-01T09:13:02.297Z","from_sync":false,"order":2,"slug":"tutorials","title":"Tutorials"},"editedParams2":true,"parentDoc":null,"project":"544fc17e698ab40800b4f891","version":{"_id":"56326e9cdf556c0d00cd08ca","project":"544fc17e698ab40800b4f891","__v":4,"createdAt":"2015-10-29T19:08:12.724Z","releaseDate":"2015-10-29T19:08:12.724Z","categories":["56326e9ddf556c0d00cd08cb","56326e9ddf556c0d00cd08cc","56326e9ddf556c0d00cd08cd","56326e9ddf556c0d00cd08ce","56326e9ddf556c0d00cd08cf","56326e9ddf556c0d00cd08d0","56326e9ddf556c0d00cd08d1","56326e9ddf556c0d00cd08d2","56326e9ddf556c0d00cd08d3","56326e9ddf556c0d00cd08d4","56d942ac337fd11300d6a251","5ab2fcf66a1d77001230b47e","5afc2943bd2ef4000330bca7"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"collector","version_clean":"2.1.0","version":"2.1"},"githubsync":"","updates":["5a04a6c439f4a10010cb539b"],"next":{"pages":[],"description":""},"createdAt":"2016-04-14T05:48:48.696Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"import json\nimport requests\n\nTOKEN = 'YOUR TOKEN'\nurl = 'https://coins.ph/api/v2/sellorder'\n\nheaders = {\n 'Authorization': 'Bearer {}'.format(TOKEN),\n 'Content-Type': 'application/json;charset=UTF-8',\n 'Accept': 'application/json'\n}\n\nbody = json.dumps({\n 'amount': 10501\n 'currency': 'PHP',\n 'payment_outlet': 'bdo',\n 'rate': 10501,\n 'pay_with_wallet': 'PBTC',\n 'bank_account_number': 1234,\n 'bank_account_name': 'Bob',\n 'sender_first_name': 'Jane',\n 'sender_middle_name': 'Michel', \n 'sender_last_name': 'Garcia',\n 'sender_address': '21 Iyam, Landing',\n 'sender_city': 'Lucena City',\n 'sender_province': 'Quezon',\n 'sender_country': 'PH',\n 'sender_postal_code': '1234',\n 'sender_phone': '+639188888888',\n 'sender_email': 'jane.garcia:::at:::gmail.com',\n})\n\nrequests.post(url, headers=headers, data=body)","language":"python"}]},"results":{"codes":[{"status":201,"language":"json","code":"{\n \"order\": {\n \"btc_amount\": 0.5000000000,\n \"confirmation_code\": \"9d6eb\",\n \"expires_epoch\": \"1402483355\",\n \"fields\": {\n \"bank_account_name\": \"John Smith\",\n \"bank_account_number\": \"0123456789\"\n },\n \"id\": \"9d6eb8f98b754cd7aa9d8d930054cda1\",\n \"payment_outlet_id\": \"bdo\",\n \"qr_img_uri\": \"https://some.url\",\n \"user_uri\": \"https://coins.ph/sellorder/9d6eb8f98b754cd7aa9d8d930054cda1\",\n \"wallet_address\": \"1234fasdf134\"\n },\n \"success\": true\n}","name":""}]},"settings":"","auth":"required","params":[{"_id":"570f3e14a38d470e0060ca9f","ref":"","in":"body","required":true,"desc":"First name of the sender.","default":"","type":"string","name":"sender_first_name"},{"_id":"570f3e14a38d470e0060ca9e","ref":"","in":"body","required":false,"desc":"Middle name of the sender.","default":"","type":"string","name":"sender_middle_name"},{"_id":"570f41fc53bfcc0e0037f31c","ref":"","in":"body","required":true,"desc":"Last name of the sender.","default":"","type":"string","name":"sender_last_name"},{"_id":"571ecfe3cb4baa0e00d13915","ref":"","in":"body","required":true,"desc":"The street address of the sender.","default":"","type":"string","name":"sender_address"},{"_id":"570f41fc53bfcc0e0037f31a","ref":"","in":"body","required":true,"desc":"The city of the sender.","default":"","type":"string","name":"sender_city"},{"_id":"571ed240ac2a080e0014c4e4","ref":"","in":"body","required":false,"desc":"The province or state of the sender.","default":"","type":"string","name":"sender_province"},{"_id":"570f41fc53bfcc0e0037f319","ref":"","in":"body","required":true,"desc":"The country of the sender. (ISO 3166-1 alpha-2 code)","default":"","type":"string","name":"sender_country"},{"_id":"571ed240ac2a080e0014c4e3","ref":"","in":"body","required":false,"desc":"The postal code (ZIP code) of the sender*.","default":"","type":"string","name":"sender_postal_code"},{"_id":"57145c0d37b7e00e00de5575","ref":"","in":"body","required":false,"desc":"Phone/Mobile number of the sender including country code (\"+631234567890\" format.)**","default":"","type":"string","name":"sender_phone"},{"_id":"57145c0d37b7e00e00de5576","ref":"","in":"body","required":false,"desc":"Email address of the sender**.","default":"","type":"string","name":"sender_email"}],"url":"/api/v2/sellorder"},"isReference":false,"order":10,"body":"Due to local regulatory requirements, remittance companies are required to provide personal details of the original sender of funds. Additional fields are required when using the [sellorder](doc:sellorder) API on behalf of a customer. No new endpoint needs to be used, these fields are submitted along with the regular sell order request payload.\n\nFor example, if you are operating a remittance service that will accept John's funds\nto be sent to Alice, you would need to provide John's details (sender) along with Alice's\ndetails (beneficiary). The required fields are described below:\n\n* **sender_first_name (required if sender_company_name is empty)** - First name of the sender.\n* **sender_middle_name** - Middle name of the sender.\n* **sender_last_name (required if it exists)** - Last name of the sender.\n* **sender_address (required)** - The street address of the sender.\n* **sender_city (required)** - The city of the sender.\n* **sender_province (required if it exists)** - The province or state of the sender.\n* **sender_country (required)** - The country of the sender. (ISO 3166-1 alpha-2 code)\n* **sender_postal_code (required if it exists)** - The postal code (ZIP code) of the sender.\n* **sender_phone (required if sender_email is empty)** - Phone/Mobile number of the sender including country code (\"+631234567890\" format.) \n* **sender_email (required if sender_phone is empty)** - Email address of the sender.\n* **sender_company_name (required if sender_first_name is empty)** - Name of the company sending out the funds\n\nHere's an example:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"import json\\nimport requests\\n\\nTOKEN = 'YOUR TOKEN'\\nurl = 'https://coins.ph/api/v2/sellorder'\\n\\nheaders = {\\n 'Authorization': 'Bearer {}'.format(TOKEN),\\n 'Content-Type': 'application/json;charset=UTF-8',\\n 'Accept': 'application/json'\\n}\\n\\nbody = json.dumps({\\n 'amount': 10501\\n 'currency': 'PHP',\\n 'payment_outlet': 'bdo',\\n 'rate': 10501,\\n 'pay_with_wallet': 'PBTC',\\n 'bank_account_number': 1234,\\n 'bank_account_name': 'Bob',\\n 'sender_first_name': 'Jane',\\n 'sender_middle_name': 'Michel',\\n 'sender_last_name': 'Garcia',\\n 'sender_address': '21 Iyam, Landing',\\n 'sender_city': 'Lucena City',\\n 'sender_province': 'Quezon',\\n 'sender_country': 'PH',\\n 'sender_postal_code': '1234',\\n 'sender_phone': '+639188888888',\\n 'sender_email': 'jane.garcia@gmail.com',\\n})\\n\\nrequests.post(url, headers=headers, data=body)\\n\",\n \"language\": \"python\",\n \"name\": \"Request\"\n },\n {\n \"code\": \"{\\n \\\"order\\\": {\\n \\\"btc_amount\\\": 0.5000000000,\\n \\\"confirmation_code\\\": \\\"9d6eb\\\",\\n \\\"expires_epoch\\\": \\\"1402483355\\\",\\n \\\"fields\\\": {\\n \\\"bank_account_name\\\": \\\"John Smith\\\",\\n \\\"bank_account_number\\\": \\\"0123456789\\\"\\n },\\n \\\"id\\\": \\\"9d6eb8f98b754cd7aa9d8d930054cda1\\\",\\n \\\"payment_outlet_id\\\": \\\"bdo\\\",\\n \\\"qr_img_uri\\\": \\\"https://some.url\\\",\\n \\\"user_uri\\\": \\\"https://coins.ph/sellorder/9d6eb8f98b754cd7aa9d8d930054cda1\\\",\\n \\\"wallet_address\\\": \\\"1234fasdf134\\\"\\n },\\n \\\"success\\\": true\\n}\\n\",\n \"language\": \"json\",\n \"name\": \"Response\"\n }\n ]\n}\n[/block]","excerpt":"Additional required fields for partner remittances using the [sellorder](http://docs.coins.asia/v2.1/docs/cash-out-for-business-account) API","slug":"cash-out-for-business-account","type":"basic","title":"Additional Sender Fields for Remittance Partners"}
Additional Sender Fields for Remittance Partners
Additional required fields for partner remittances using the [sellorder](http://docs.coins.asia/v2.1/docs/cash-out-for-business-account) API