🇬🇧
Yativo Documentation
Spanish
English
English
  • Yativo
  • Introduction to Yativo
    • Financial Infrastructure
    • About Us
  • Dashboard
  • Business Plans
  • Getting Started with Yativo API
  • Yativo API Glossary
  • API reference
    • Misc.
      • Countries
      • States
      • City
  • Security and Authentication
    • Security
    • Authentication
    • Idempotency in API Requests
  • Environment
    • Environments
  • Notifications
    • Webhook
  • Compliance
    • Verification
      • KYC
      • KYB
      • KYC/KYB Update
      • KYC Status
      • Global Business Search
    • Supported Jurisdiction
    • Supported Countries, Currencies and Payment Method
  • User Management
    • Customer
      • Get Customers
      • Retrieve customer
      • Add Customer
  • Payments
    • Currencies
    • Crypto Wallets
      • Generate Wallet Address
      • Fetch Wallet Address
      • Crypto Deposit History
      • Single crypto deposit history
    • Payout
      • Payout
      • Get Payouts
      • Get Payout
      • Beneficiaries
        • Get Beneficiaries
        • Add Beneficiary Payment Details
        • Update Beneficiary
        • Archive Beneficiary
        • Add Beneficiary
    • Payin
    • Virtual Cards
      • Supported Currency, Country
      • Create card
      • Fetch card
      • Top up card
      • Get Transactions
      • Freeze and Unfreeze Card
    • Virtual Accounts
      • Create VIrtual Accounts
        • USD Virtual Account
        • Mexico Virtual Account
        • Brazil PIX QR
      • Virtual Account Management
      • Transaction History
  • Foreign Exchange
    • Exchange Rate
      • Request Quote
  • Transactions
    • Transaction Summary
    • Get Single Transaction
  • Crypto System
    • Yativo Crypto Platform API
Powered by GitBook
On this page
  1. Payments
  2. Virtual Accounts
  3. Create VIrtual Accounts

Mexico Virtual Account

PreviousUSD Virtual AccountNextBrazil PIX QR

Last updated 1 month ago

Mexican Virtual Account Creation Documentation

Overview

This document provides guidelines for creating a virtual account for Mexican residents or non-residents with a completed and approved profile. Virtual accounts facilitate seamless financial transactions and can be tailored to specific customer needs.

Endpoint

POST {{baseUrl}}/business/virtual-account/create

Request Body

The request body should contain the following parameters:

  • customer_id: (string) The unique identifier of the customer requesting the virtual account creation.

  • currency: (string) The currency code for the virtual account. For Mexican virtual accounts, the currency code should be "MXN".

Example Request

{
    "customer_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx" //optional
    "currency": "MEX"
}

Response

Upon successful virtual account creation, the server will respond with a status code of 200 and a JSON response indicating the success of the request.

  • status: (string) A string indicating the result of the request.

  • status_code: (integer) A numerical code representing the HTTP status.

  • message: (string) A descriptive message about the status of the request.

{
    "status": "success",
    "status_code": 200,
    "message": "Request successful",
    "data": {
        "message": "Virtual account creation in progress"
    }
}

Error Handling

If there are any errors or issues with the request, the server will respond with an appropriate error status code along with a message describing the issue.

Example Error Response:

{
    "status": "error",
    "status_code": 400,
    "message": "Request failed",
    "data" : {
        "message": "Invalid document type provided"
    }
}

Notes

  • Ensure that the provided customer ID is valid and corresponds to an existing customer.

  • The document ID and document type should be accurately provided to verify the customer's identity.

  • It's important to adhere to the acceptable document types specified in the documentation.

This documentation serves as a guide for developers and stakeholders involved in integrating virtual account creation functionality for Mexican residents or non-residents.

KYC