Mono Colombia
GuidesAPI reference
BankingBank Transfers

Create bank transfers

Creates and sends a batch of bank transfers without the requiring of an additional authorization, this can be between accounts of the same or different banks, which allows multiple transfers to be processed together in a single request.

When the server receives the request, it will process it and initiate the transfer of funds between the source and destination bank accounts. This involves debiting the appropriate amount from the source account, and crediting the destination account with the transferred funds.

This endpoint is used in cases where the client wants to initiate bank transfers from their own system or application, without the need to log in to their bank's website or use a separate banking app. This can be useful for a variety of purposes, such as to automate financial operations, to streamline the payment process, or to provide a more convenient user experience.

Considerations:

  1. API key role allowed to consume this endpoint is "Administrator".
  2. The minimum number of transfers allowed per batch is 1.
  3. The maximum number of transfers allowed per batch are 1.000.
POST
/v1/transfers

Authorization

authorization

AuthorizationBearer <token>

In: header

Header Parameters

x-idempotency-key?string

Idempotency key in UUID v4 format

Formatuuid
Example"f30f1d0b-795f-49f5-80dc-41a7bffccfde"

Request Body

application/json

Attributes to create a batch of transfers

account_idstring

Represents the account of the client to which a debit entry will be made as a result of the transaction.

Match^[A-Za-z]{2,6}_[\w-]{22}$
Example"acc_5tgliBmzjZ6mpQPRbQjfKj"
transfersarray<Transfer>

It contains a list with transfers

Items1 <= items <= 1000

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.cert.monoban.co/v1/transfers" \  -H "Content-Type: application/json" \  -d '{    "account_id": "acc_5tgliBmzjZ6mpQPRbQjfKj",    "transfers": [      {        "payee": {          "document_number": "string",          "document_type": "CC",          "name": "string"        },        "amount": {          "amount": 100000000,          "currency": "COP"        }      }    ]  }'
{
  "account_id": "acc_5tgliBmzjZ6mpQPRbQjfKj",
  "transfers": [
    {
      "fallback_routing": [],
      "payee": {
        "bank_account": {
          "bank_code": "string",
          "number": "123456789",
          "type": "savings_account"
        },
        "document_number": "string",
        "document_type": "CC",
        "email": "someone@gmail.com",
        "name": "string",
        "phone_number": "+573001000000"
      },
      "routing": "ach",
      "amount": {
        "amount": 100000000,
        "currency": "COP"
      },
      "batch": {
        "account_id": "acc_5tgliBmzjZ6mpQPRbQjfKj",
        "id": "bat_5tgliBmzjZ6mpQPRbQjfKj",
        "inserted_at": "2022-01-01T01:00:00Z",
        "origin": "api",
        "state": "created",
        "total_amount": {
          "amount": 100000000,
          "currency": "COP"
        },
        "updated_at": "2022-01-01T01:00:00Z"
      },
      "declination_reason": "insufficient_funds",
      "description": "string",
      "emails_to_notify": [
        "someone@gmail.com"
      ],
      "entity_id": "string",
      "external_id": "123456789",
      "id": "trn_5tgliBmzjZ6mpQPRbQjfKj",
      "inserted_at": "2022-01-01T01:00:00Z",
      "reference": "string",
      "state": "created",
      "updated_at": "2022-01-01T01:00:00Z"
    }
  ]
}
{
  "account_id": "acc_5tgliBmzjZ6mpQPRbQjfKj",
  "transfers": [
    {
      "fallback_routing": [],
      "payee": {
        "bank_account": {
          "bank_code": "string",
          "number": "123456789",
          "type": "savings_account"
        },
        "document_number": "string",
        "document_type": "CC",
        "email": "someone@gmail.com",
        "name": "string",
        "phone_number": "+573001000000"
      },
      "routing": "ach",
      "amount": {
        "amount": 100000000,
        "currency": "COP"
      },
      "batch": {
        "account_id": "acc_5tgliBmzjZ6mpQPRbQjfKj",
        "id": "bat_5tgliBmzjZ6mpQPRbQjfKj",
        "inserted_at": "2022-01-01T01:00:00Z",
        "origin": "api",
        "state": "created",
        "total_amount": {
          "amount": 100000000,
          "currency": "COP"
        },
        "updated_at": "2022-01-01T01:00:00Z"
      },
      "declination_reason": "insufficient_funds",
      "description": "string",
      "emails_to_notify": [
        "someone@gmail.com"
      ],
      "entity_id": "string",
      "external_id": "123456789",
      "id": "trn_5tgliBmzjZ6mpQPRbQjfKj",
      "inserted_at": "2022-01-01T01:00:00Z",
      "reference": "string",
      "state": "created",
      "updated_at": "2022-01-01T01:00:00Z"
    }
  ]
}
{
  "code": "400 Bad Request",
  "errors": [
    {
      "error_code": "validation_error",
      "message": "Generic changeset errors",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Malformed request"
}
{
  "code": "401 Unauthorized",
  "errors": [
    {
      "error_code": "expired_token",
      "message": "The token is expired, inactive, or doesn't exist.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Authorization header is missing or invalid."
}
{
  "code": "403 Forbidden",
  "errors": [
    {
      "error_code": "not_authorized",
      "message": "Not authorized to have access to this resource.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Not authorized to have access to this resource"
}
{
  "code": "422 Unprocessable Entity",
  "errors": [
    {
      "error_code": "missing_field",
      "message": "The field is missing on the request body or parameters.",
      "path": "#/path/to/field",
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Validation errors"
}

Get banks GET

Previous Page

List bank transfers GET

Next Page