{"_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":2,"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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"collector","version_clean":"2.1.0","version":"2.1"},"updates":["5a04a6c439f4a10010cb539b"],"next":{"pages":[],"description":""},"createdAt":"2016-04-14T05:48:48.696Z","link_external":false,"link_url":"","githubsync":"","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

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. For example, if you are operating a remittance service that will accept John's funds to be sent to Alice, you would need to provide John's details (sender) along with Alice's details (beneficiary). The required fields are described below: * **sender_first_name (required if sender_company_name is empty)** - First name of the sender. * **sender_middle_name** - Middle name of the sender. * **sender_last_name (required if it exists)** - Last name of the sender. * **sender_address (required)** - The street address of the sender. * **sender_city (required)** - The city of the sender. * **sender_province (required if it exists)** - The province or state of the sender. * **sender_country (required)** - The country of the sender. (ISO 3166-1 alpha-2 code) * **sender_postal_code (required if it exists)** - The postal code (ZIP code) of the sender. * **sender_phone (required if sender_email is empty)** - Phone/Mobile number of the sender including country code ("+631234567890" format.) * **sender_email (required if sender_phone is empty)** - Email address of the sender. * **sender_company_name (required if sender_first_name is empty)** - Name of the company sending out the funds Here's an example: [block:code] { "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@gmail.com',\n})\n\nrequests.post(url, headers=headers, data=body)\n", "language": "python", "name": "Request" }, { "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", "language": "json", "name": "Response" } ] } [/block]