v1

latestOpenAPI 3.1.02026-07-2479154362.5 KB

payin

Create payment intent

post/payin/intent

Request body

destination_idstring uuid required

Merchant Account ID

external_idstring required

Id used to track the payin

conceptstring

Concept associated with the payment intent. This text will be reflected as a concept in the bank issuing the payment.

currencystring required

ISO-4217 currency code

amountnumber double required

String encoded decimal number

payment_method'transfer' | 'qr'

Required for Peru: must be "qr".
Optional for other countries: defaults to "transfer".

Example request

{
  "destination_id": "f3676011-5203-43db-a760-115203e3db5e",
  "external_id": "e5af7e6e-98f4-4e43-af7e-6e98f42e43ef",
  "concept": "Some concept",
  "currency": "MXN",
  "amount": 10,
  "payment_method": "transfer",
  "customer": "0f4b1587-7708-4b1a-8b15-877708db1a2c"
}

Response

Intent Created

idstring uuid required

Identifies a payin intent

Example response

{
  "customer": {
    "name": "Jane Doe",
    "tax_id_type": "rfc",
    "tax_id": "DODJ2301016J3",
    "external_id": "SOME_PREFIX:SOME_UNIQUE_ID",
    "virtual_account": {
      "account_format": "clabe",
      "account_number": "012180826854179156",
      "name": "Jane Doe",
      "branch": "0",
      "bank": {
        "code": "012",
        "bicfi": "BBVAMXMMXXX",
        "name": "BBVA",
        "country": "MX"
      }
    },
    "qr_code": {
      "emv_code": "00020101021226830014...",
      "img": "base64...",
      "external_link": "https://example.com/?hash=...",
      "expire_date": "2026-12-31 23:59:59"
    }
  }
}