Additional required fields for partner remittances using the sellorder 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 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:

import json
import requests

TOKEN = 'YOUR TOKEN'
url = 'https://coins.ph/api/v2/sellorder'

headers = {
    'Authorization': 'Bearer {}'.format(TOKEN),
    'Content-Type': 'application/json;charset=UTF-8',
    'Accept': 'application/json'
}

body = json.dumps({
    'amount': 10501
    'currency': 'PHP',
    'payment_outlet': 'bdo',
    'rate': 10501,
    'pay_with_wallet': 'PBTC',
    'bank_account_number': 1234,
    'bank_account_name': 'Bob',
    'sender_first_name': 'Jane',
    'sender_middle_name': 'Michel',
    'sender_last_name': 'Garcia',
    'sender_address': '21 Iyam, Landing',
    'sender_city': 'Lucena City',
    'sender_province': 'Quezon',
    'sender_country': 'PH',
    'sender_postal_code': '1234',
    'sender_phone': '+639188888888',
    'sender_email': '[email protected]',
})

requests.post(url, headers=headers, data=body)
{
  "order": {
    "btc_amount": 0.5000000000,
    "confirmation_code": "9d6eb",
    "expires_epoch": "1402483355",
    "fields": {
      "bank_account_name": "John Smith",
      "bank_account_number": "0123456789"
    },
    "id": "9d6eb8f98b754cd7aa9d8d930054cda1",
    "payment_outlet_id": "bdo",
    "qr_img_uri": "https://some.url",
    "user_uri": "https://coins.ph/sellorder/9d6eb8f98b754cd7aa9d8d930054cda1",
    "wallet_address": "1234fasdf134"
  },
  "success": true
}