ZINC API
HomeSign InSupport
HomeSign InSupport
  1. Accounts
  • API Reference
  • Authentication
    • Get Access token
      GET
  • Core Resources
    • Accounts
      • Create Account
        POST
      • Get Account
        GET
      • Update Account
        POST
      • Get Account Balance
        GET
      • Submit Account For Activation
        POST
      • Get Account Transactions
        GET
      • Get Account Supported Currencies
        GET
      • Get Account Beneficiaries
        GET
    • Beneficiary
      • Add Beneficiary
      • Get Beneficiaries
      • Delete Beneficiary
    • Currency Accounts
      • Create Currency Account
      • Get Currency Account Details
    • Payouts
      • Create Payout
      • Get Payouts For Account
    • Cards
      • Simulation
        • Simulate Card Transaction
      • Create Card
      • Get Card Details
      • Update Transaction Limits
      • Update Cards Status
      • Get Card Transactions
    • Conversions
      • Create Conversion
      • Get Quote
    • Services
      • Upload File
  1. Accounts

Update Account

POST
/api/v1/account/{id}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
id
string 
required
Header Params
x-api-version
string 
optional
Body Params application/json
account_details
object 
required
beneficial_owners
array [object {3}] 
required
business_details
object 
required
legal_rep_details
object 
required
account_usage
object 
required
card_usage
array[string]
required
collection_country_codes
array[string]
required
collection_from
array[string]
required
expected_monthly_transaction_volume
object 
required
payout_country_codes
array[string]
required
payout_to
array[string]
required
customer_agreements
object 
required
agreed_to_data_usage
boolean 
required
agreed_to_terms_and_conditions
boolean 
required
opt_in_for_marketing
boolean 
required
primary_contact
object 
required
email
string 
required
Example
{
    "account_details": {
        "beneficial_owners": [
            {
                "identification_type": "PERSONAL_ID",
                "nationality": "SG",
                "attachments": {
                    "identity_files": [
                        {
                            "description": "{{filename}}",
                            "file_id": "{{file_id}}",
                            "tag": "PERSONAL_ID_FRONT"
                        },
                        {
                            "description": "{{filename}}",
                            "file_id": "{{file_id}}",
                            "tag": "PERSONAL_ID_BACK"
                        }
                    ]
                }
            }
        ],
        "business_details": {
            "address": {
                "country_code": "SG"
            },
            "industry_category": "E-Commerce - Merchant",
            "purpose": "Payment to service providers - Shipping & Delivery Companies/Agencies",
            "url": "http://www.example.com",
            "attachments": {
                "business_documents": [
                    {
                        "description": "{{filename}}",
                        "file_id": "{{file_id}}",
                        "tag": "BUSINESS_LICENSE"
                    }
                ]
            }
        },
        "legal_rep_details": {
            "attachments": {
                "identity_files": [
                    {
                        "description": "{{filename}}",
                        "file_id": "{{file_id}}",
                        "tag": "PERSONAL_ID_FRONT"
                    },
                    {
                        "description": "{{filename}}",
                        "file_id": "{{file_id}}",
                        "tag": "PERSONAL_ID_BACK"
                    }
                ]
            },
            "identification_type": "PERSONAL_ID",
            "nationality": "CN"
        }
    },
    "account_usage": {
        "card_usage": [
            "NONE"
        ],
        "collection_country_codes": [
            "SG"
        ],
        "collection_from": [
            "CLIENTS_AND_OTHER_THIRD_PARTIES"
        ],
        "expected_monthly_transaction_volume": {
            "amount": "100000.0"
        },
        "payout_country_codes": [
            "US"
        ],
        "payout_to": [
            "VENDORS_SUPPLIERS_OR_OTHER_THIRD_PARTY_BANK_ACCOUNT",
            "WITHDRAWAL_TO_BANK_ACCOUNT_UNDER_THE_SAME_NAME"
        ]
    },
    "customer_agreements": {
        "agreed_to_data_usage": true,
        "agreed_to_terms_and_conditions": true,
        "opt_in_for_marketing": false
    },
    "primary_contact": {
        "email": "test+{{$guid}}@example.com"
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-sandbox.z.inc/api/v1/account/' \
--header 'x-api-version;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account_details": {
        "beneficial_owners": [
            {
                "identification_type": "PERSONAL_ID",
                "nationality": "SG",
                "attachments": {
                    "identity_files": [
                        {
                            "description": "{{filename}}",
                            "file_id": "{{file_id}}",
                            "tag": "PERSONAL_ID_FRONT"
                        },
                        {
                            "description": "{{filename}}",
                            "file_id": "{{file_id}}",
                            "tag": "PERSONAL_ID_BACK"
                        }
                    ]
                }
            }
        ],
        "business_details": {
            "address": {
                "country_code": "SG"
            },
            "industry_category": "E-Commerce - Merchant",
            "purpose": "Payment to service providers - Shipping & Delivery Companies/Agencies",
            "url": "http://www.example.com",
            "attachments": {
                "business_documents": [
                    {
                        "description": "{{filename}}",
                        "file_id": "{{file_id}}",
                        "tag": "BUSINESS_LICENSE"
                    }
                ]
            }
        },
        "legal_rep_details": {
            "attachments": {
                "identity_files": [
                    {
                        "description": "{{filename}}",
                        "file_id": "{{file_id}}",
                        "tag": "PERSONAL_ID_FRONT"
                    },
                    {
                        "description": "{{filename}}",
                        "file_id": "{{file_id}}",
                        "tag": "PERSONAL_ID_BACK"
                    }
                ]
            },
            "identification_type": "PERSONAL_ID",
            "nationality": "CN"
        }
    },
    "account_usage": {
        "card_usage": [
            "NONE"
        ],
        "collection_country_codes": [
            "SG"
        ],
        "collection_from": [
            "CLIENTS_AND_OTHER_THIRD_PARTIES"
        ],
        "expected_monthly_transaction_volume": {
            "amount": "100000.0"
        },
        "payout_country_codes": [
            "US"
        ],
        "payout_to": [
            "VENDORS_SUPPLIERS_OR_OTHER_THIRD_PARTY_BANK_ACCOUNT",
            "WITHDRAWAL_TO_BANK_ACCOUNT_UNDER_THE_SAME_NAME"
        ]
    },
    "customer_agreements": {
        "agreed_to_data_usage": true,
        "agreed_to_terms_and_conditions": true,
        "opt_in_for_marketing": false
    },
    "primary_contact": {
        "email": "test+{{$guid}}@example.com"
    }
}'

Responses

🟢200Success
application/json
Body
object {0}
Example
{}
Modified at 2024-07-28 14:45:19
Previous
Get Account
Next
Get Account Balance