Additional Sender Fields for Remittance Partners

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]

Coins

Getting Started

Authentication

Tutorials

Merchants

Webhooks

Cash In

Payin Outlets

Cash Out

Payout Outlets

Payment Requests

Wallets

Additional Sender Fields for Remittance Partners