Overview
OAuth2
- Authentication
Widget
Trading
- Reusable Quotes
- Swap Reusable Quotes
- Reusable Quote Execution
- Swap Reusable Quote Execution
- Rates
- Pairs
Transactions
- Transactions
- Transactional Limits
End Users
- End Users
- End User Management
Onchain Deposits & Withdrawals
- Withdrawals
- Addresses
- Auto Swap Addresses
- Deposits
Sandbox
- IPN Webhooks
- Deposit IPN
- Simulate Fiat Deposit
Banking as a Service
- Beneficiary Fiat Accounts
- Fiat Accounts
- Fiat Withdrawals
- Fiat Deposits
- KYC Requirements
- KYC Submissions
Webhooks
🚧 WIP: Yields
- Opt Ins
- Opt Outs
- Yield credits
- Yield APY
KYC Requirements
This endpoint returns a list of fields that needs to be provided on a KYC submission. The response is structured in a list of fields so that an UI can be constructed from it.
curl --request GET \
--url https://sandbox-b2b.ripio.com/api/v1/kyc-requirements \
--header 'Authorization: Bearer <token>'
{
"kyc_required_fields": [
{
"field_name": "country",
"required": true,
"type": "CHOICE",
"choices": [
{
"value": "AR",
"label": "Argentina"
}
]
},
{
"field_name": "first_name",
"required": true,
"type": "TEXT"
},
{
"field_name": "last_name",
"required": true,
"type": "TEXT"
},
{
"field_name": "gender",
"required": true,
"type": "CHOICE",
"choices": [
{
"value": "M",
"label": "Male"
},
{
"value": "F",
"label": "Female"
}
]
},
{
"field_name": "birthday",
"required": true,
"type": "DATE"
},
{
"field_name": "nationality",
"required": true,
"type": "TEXT"
},
{
"field_name": "id_number",
"required": true,
"type": "NUMERIC"
},
{
"field_name": "address",
"required": true,
"type": "TEXT"
},
{
"field_name": "address_flat",
"required": false,
"type": "TEXT"
},
{
"field_name": "address_number",
"required": true,
"type": "NUMERIC"
},
{
"field_name": "postal_code",
"required": true,
"type": "TEXT"
},
{
"field_name": "city",
"required": true,
"type": "TEXT"
},
{
"field_name": "state",
"required": true,
"type": "CHOICE",
"choices": [
{
"value": "AR.BA",
"label": "Buenos Aires"
},
{
"value": "AR.CT",
"label": "Catamarca"
},
{
"value": "AR.CC",
"label": "Chaco"
},
{
"value": "AR.CH",
"label": "Chubut"
},
{
"value": "AR.DF",
"label": "Ciudad de Buenos Aires"
},
{
"value": "AR.CB",
"label": "Córdoba"
},
{
"value": "AR.CN",
"label": "Corrientes"
},
{
"value": "AR.ER",
"label": "Entre Ríos"
},
{
"value": "AR.FM",
"label": "Formosa"
},
{
"value": "AR.JY",
"label": "Jujuy"
},
{
"value": "AR.LP",
"label": "La Pampa"
},
{
"value": "AR.LR",
"label": "La Rioja"
},
{
"value": "AR.MZ",
"label": "Mendoza"
},
{
"value": "AR.MN",
"label": "Misiones"
},
{
"value": "AR.NQ",
"label": "Neuquén"
},
{
"value": "AR.RN",
"label": "Río Negro"
},
{
"value": "AR.SA",
"label": "Salta"
},
{
"value": "AR.SJ",
"label": "San Juan"
},
{
"value": "AR.SL",
"label": "San Luis"
},
{
"value": "AR.SC",
"label": "Santa Cruz"
},
{
"value": "AR.SF",
"label": "Santa Fe"
},
{
"value": "AR.SE",
"label": "Santiago del Estero"
},
{
"value": "AR.TF",
"label": "Tierra del Fuego"
},
{
"value": "AR.TM",
"label": "Tucumán"
}
]
},
{
"field_name": "phone",
"required": true,
"type": "TEXT"
},
{
"field_name": "registered_tax_payer",
"required": true,
"type": "BOOLEAN"
},
{
"field_name": "cuit",
"required": true,
"type": "TEXT"
},
{
"field_name": "net_income",
"required": true,
"type": "CHOICE",
"choices": [
{
"label": "Menos de 3.000.000 ARS",
"value": "AR.A"
},
{
"label": "3.000.000 a 5.000.000 ARS",
"value": "AR.B"
},
{
"label": "5.000.000 a 8.000.000 ARS",
"value": "AR.C"
},
{
"label": "8.000.000 a 11.000.000 ARS",
"value": "AR.D"
},
{
"label": "11.000.000 a 15.000.000 ARS",
"value": "AR.E"
},
{
"label": "Más de 15.000.000 ARS",
"value": "AR.F"
}
]
},
{
"field_name": "personal_activity",
"required": true,
"type": "CHOICE",
"choices": [
{
"value": "AR.1",
"label": "Empleado del Sector Privado"
},
{
"value": "AR.2",
"label": "Empleado del Sector Público"
},
{
"value": "AR.3",
"label": "Monotributista"
},
{
"value": "AR.4",
"label": "Autonomo"
},
{
"value": "AR.5",
"label": "Jubilado/ Pensionado"
},
{
"value": "AR.6",
"label": "Estudiante/ Ama de Casa/ Desempleado"
}
]
},
{
"field_name": "personal_activity_other",
"required": false,
"type": "CHOICE",
"choices": [
{
"value": "AR.1",
"label": "Fabricación de joyas finas, bijouterie y artículos conexos"
},
{
"value": "AR.2",
"label": "Pompas fúnebres y servicios conexos"
},
{
"value": "AR.3",
"label": "Servicio de transporte aéreo de pasajeros y/o de cargas"
},
{
"value": "AR.4",
"label": "Servicio de transporte automotor de mercaderías a granel, cereales, animales y/o sustancias peligrosas"
},
{
"value": "AR.5",
"label": "Servicio de transporte ferroviario/automotor"
},
{
"value": "AR.6",
"label": "Servicio de transporte marítimo/fluvial y lacustre"
},
{
"value": "AR.7",
"label": "Servicios auxiliares a la intermediación financiera"
},
{
"value": "AR.8",
"label": "Servicios de administración de consorcios de edificios"
},
{
"value": "AR.9",
"label": "Servicios de alojamiento por hora, temporal, en campings, pensiones, hoteles, hosterías y/o residenciales similares"
},
{
"value": "AR.10",
"label": "Servicios de asociaciones"
},
{
"value": "AR.11",
"label": "Servicios de centros de estética, spa y similares"
},
{
"value": "AR.12",
"label": "Servicios de comidas \"fast food\", comida para llevar, helados, realizadas por/para vendedores ambulantes o para empresas y eventos"
},
{
"value": "AR.13",
"label": "Servicios de consorcios de edificios"
},
{
"value": "AR.14",
"label": "Servicios de cooperativas cuando realizan varias actividades"
},
{
"value": "AR.15",
"label": "Servicios de desarrollo de software y/o portales web"
},
{
"value": "AR.16",
"label": "Servicios de emergencias y traslados"
},
{
"value": "AR.17",
"label": "Servicios de enseñanza"
},
{
"value": "AR.18",
"label": "Servicios de entretenimiento"
},
{
"value": "AR.19",
"label": "Servicios de financiación y actividades financieras, o fondos y sociedades de inversión y entidades financieras similares"
},
{
"value": "AR.20",
"label": "Servicios de gestión de fondos a cambio de una retribución o por contratación"
},
{
"value": "AR.21",
"label": "Servicios de intermediación financiera realizada por financieras, sociedades de ahorro y préstamo, o cajas de crédito"
},
{
"value": "AR.22",
"label": "Servicios de la banca central, minorista, mayorista o de inversion"
},
{
"value": "AR.23",
"label": "Servicios de limpieza de prendas prestado por tintorerías rápidas"
},
{
"value": "AR.24",
"label": "Servicios de mudanza"
},
{
"value": "AR.25",
"label": "Servicios de mutuales, excepto mutuales de salud y financieras"
},
{
"value": "AR.26",
"label": "Servicios de organización de convenciones y exposiciones comerciales, excepto culturales y deportivos"
},
{
"value": "AR.27",
"label": "Servicios de organización, dirección y gestión de prácticas deportivas en clubes, espectáculos deportivos"
},
{
"value": "AR.28",
"label": "Servicios de organizaciones empresariales y de empleadores, o profesionales"
},
{
"value": "AR.29",
"label": "Servicios de organizaciones políticas"
},
{
"value": "AR.30",
"label": "Servicios de organizaciones religiosas"
},
{
"value": "AR.31",
"label": "Servicios de organizaciones y órganos extraterritoriales"
},
{
"value": "AR.32",
"label": "Servicios de parques de diversiones y parques temáticos"
},
{
"value": "AR.33",
"label": "Servicios de peluquería o tratamientos de belleza"
},
{
"value": "AR.34",
"label": "Servicios de producción de espectáculos artísticos, teatrales y musicales"
},
{
"value": "AR.35",
"label": "Servicios de restaurantes, cantinas y/o bares"
},
{
"value": "AR.36",
"label": "Servicios de salones de juegos"
},
{
"value": "AR.37",
"label": "Servicios de seguridad e investigación"
},
{
"value": "AR.38",
"label": "Servicios de seguros de salud, vida o patrimoniales excepto los de las aseguradoras de riesgo de trabajo (ART)"
},
{
"value": "AR.39",
"label": "Servicios de sindicatos"
},
{
"value": "AR.40",
"label": "Servicios empresariales"
},
{
"value": "AR.41",
"label": "Servicios inmobiliarios realizados por cuenta propia, con bienes urbanos/rurales propios o arrendados"
},
{
"value": "AR.42",
"label": "Servicios jurídicos"
},
{
"value": "AR.43",
"label": "Servicios personales"
},
{
"value": "AR.44",
"label": "Servicios prestados por deportistas y atletas para la realización de prácticas deportivas"
},
{
"value": "AR.45",
"label": "Servicios prestados por profesionales y técnicos para la realización de prácticas deportivas"
},
{
"value": "AR.46",
"label": "Servicios relacionados a activos virtuales y/o criptominería"
},
{
"value": "AR.47",
"label": "Servicios relacionados a la construcción, reforma y/o reparación de edificios, obras relacionadas al transporte y/o redes de servicios públicos"
},
{
"value": "AR.48",
"label": "Servicios relacionados a la fabricación d productos químicos, medicamentos de uso humano y productos de uso farmacéutico"
},
{
"value": "AR.49",
"label": "Servicios relacionados a la minería, metales preciosos y no ferrosos"
},
{
"value": "AR.50",
"label": "Servicios relacionados a los reaseguros"
},
{
"value": "AR.51",
"label": "Servicios relacionados a obras sociales"
},
{
"value": "AR.52",
"label": "Servicios relacionados al arrendamiento y gestión de bienes intangibles no financieros"
},
{
"value": "AR.53",
"label": "Servicios relacionados al procesamiento/ hospedaje de datos"
},
{
"value": "AR.54",
"label": "Servicios relacionados con juegos de azar y apuestas"
},
{
"value": "AR.55",
"label": "Venta al por mayor en comisión o consignación de madera y materiales para la construcción"
},
{
"value": "AR.56",
"label": "Venta al por mayor en comisión o consignación de maquinaria, equipo profesional industrial y comercial, embarcaciones y aeronaves"
},
{
"value": "AR.57",
"label": "Venta al por mayor en comisión o consignación de alimentos, bebidas y tabaco"
},
{
"value": "AR.58",
"label": "Venta al por mayor en comisión o consignación de combustibles"
},
{
"value": "AR.59",
"label": "Venta al por mayor en comisión o consignación de papel, cartón, libros, revistas, diarios, materiales de embalaje y artículos de librería"
},
{
"value": "AR.60",
"label": "Venta al por mayor en comisión o consignación de productos agrícolas y/o pecuarios"
},
{
"value": "AR.61",
"label": "Venta al por menor de productos alimenticios en comercios especializados"
},
{
"value": "AR.62",
"label": "Venta al por menor no realizada en establecimientos"
},
{
"value": "AR.63",
"label": "Venta, mantenimiento y/o reparación de vehículos automotores/motocicletas nuevos o al por mayor de partes, piezas y accesorios"
},
{
"value": "AR.64",
"label": "Otro"
}
]
}
]
}
Each field has the following structure:
{
"field_name": string,
"required": boolean,
"type": string (TEXT, BOOLEAN, DATE, NUMERIC, CHOICE),
"choices": array,
"value": label,
"label": string
}
Notes:
id_number
is DNI for Argentina.registered_tax_payer
in Argentina is “Responsable Inscripto”.
Authorizations
B2B’s White Label API uses OAuth2. Currently there is only one supported authentication flow:
- clientCredentials allows you to access your own B2B account (First-Party Integration) and performs transactions against the public API. This oauth2 flow is well suited for this API, as it allows machine-to-machine communication.
Every call to the API has to be authenticated with an OAuth2 Token. In order to request this token, you will need to have sandbox or production API Keys (client id and client secret) that will be needed to generate a credential in order to negotiate an ephemeral access token.
Every request must be accompianed by an Authorization
header with a value that follows the following schema: Bearer ACCESS_TOKEN
Response
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://sandbox-b2b.ripio.com/api/v1/kyc-requirements \
--header 'Authorization: Bearer <token>'
{
"kyc_required_fields": [
{
"field_name": "country",
"required": true,
"type": "CHOICE",
"choices": [
{
"value": "AR",
"label": "Argentina"
}
]
},
{
"field_name": "first_name",
"required": true,
"type": "TEXT"
},
{
"field_name": "last_name",
"required": true,
"type": "TEXT"
},
{
"field_name": "gender",
"required": true,
"type": "CHOICE",
"choices": [
{
"value": "M",
"label": "Male"
},
{
"value": "F",
"label": "Female"
}
]
},
{
"field_name": "birthday",
"required": true,
"type": "DATE"
},
{
"field_name": "nationality",
"required": true,
"type": "TEXT"
},
{
"field_name": "id_number",
"required": true,
"type": "NUMERIC"
},
{
"field_name": "address",
"required": true,
"type": "TEXT"
},
{
"field_name": "address_flat",
"required": false,
"type": "TEXT"
},
{
"field_name": "address_number",
"required": true,
"type": "NUMERIC"
},
{
"field_name": "postal_code",
"required": true,
"type": "TEXT"
},
{
"field_name": "city",
"required": true,
"type": "TEXT"
},
{
"field_name": "state",
"required": true,
"type": "CHOICE",
"choices": [
{
"value": "AR.BA",
"label": "Buenos Aires"
},
{
"value": "AR.CT",
"label": "Catamarca"
},
{
"value": "AR.CC",
"label": "Chaco"
},
{
"value": "AR.CH",
"label": "Chubut"
},
{
"value": "AR.DF",
"label": "Ciudad de Buenos Aires"
},
{
"value": "AR.CB",
"label": "Córdoba"
},
{
"value": "AR.CN",
"label": "Corrientes"
},
{
"value": "AR.ER",
"label": "Entre Ríos"
},
{
"value": "AR.FM",
"label": "Formosa"
},
{
"value": "AR.JY",
"label": "Jujuy"
},
{
"value": "AR.LP",
"label": "La Pampa"
},
{
"value": "AR.LR",
"label": "La Rioja"
},
{
"value": "AR.MZ",
"label": "Mendoza"
},
{
"value": "AR.MN",
"label": "Misiones"
},
{
"value": "AR.NQ",
"label": "Neuquén"
},
{
"value": "AR.RN",
"label": "Río Negro"
},
{
"value": "AR.SA",
"label": "Salta"
},
{
"value": "AR.SJ",
"label": "San Juan"
},
{
"value": "AR.SL",
"label": "San Luis"
},
{
"value": "AR.SC",
"label": "Santa Cruz"
},
{
"value": "AR.SF",
"label": "Santa Fe"
},
{
"value": "AR.SE",
"label": "Santiago del Estero"
},
{
"value": "AR.TF",
"label": "Tierra del Fuego"
},
{
"value": "AR.TM",
"label": "Tucumán"
}
]
},
{
"field_name": "phone",
"required": true,
"type": "TEXT"
},
{
"field_name": "registered_tax_payer",
"required": true,
"type": "BOOLEAN"
},
{
"field_name": "cuit",
"required": true,
"type": "TEXT"
},
{
"field_name": "net_income",
"required": true,
"type": "CHOICE",
"choices": [
{
"label": "Menos de 3.000.000 ARS",
"value": "AR.A"
},
{
"label": "3.000.000 a 5.000.000 ARS",
"value": "AR.B"
},
{
"label": "5.000.000 a 8.000.000 ARS",
"value": "AR.C"
},
{
"label": "8.000.000 a 11.000.000 ARS",
"value": "AR.D"
},
{
"label": "11.000.000 a 15.000.000 ARS",
"value": "AR.E"
},
{
"label": "Más de 15.000.000 ARS",
"value": "AR.F"
}
]
},
{
"field_name": "personal_activity",
"required": true,
"type": "CHOICE",
"choices": [
{
"value": "AR.1",
"label": "Empleado del Sector Privado"
},
{
"value": "AR.2",
"label": "Empleado del Sector Público"
},
{
"value": "AR.3",
"label": "Monotributista"
},
{
"value": "AR.4",
"label": "Autonomo"
},
{
"value": "AR.5",
"label": "Jubilado/ Pensionado"
},
{
"value": "AR.6",
"label": "Estudiante/ Ama de Casa/ Desempleado"
}
]
},
{
"field_name": "personal_activity_other",
"required": false,
"type": "CHOICE",
"choices": [
{
"value": "AR.1",
"label": "Fabricación de joyas finas, bijouterie y artículos conexos"
},
{
"value": "AR.2",
"label": "Pompas fúnebres y servicios conexos"
},
{
"value": "AR.3",
"label": "Servicio de transporte aéreo de pasajeros y/o de cargas"
},
{
"value": "AR.4",
"label": "Servicio de transporte automotor de mercaderías a granel, cereales, animales y/o sustancias peligrosas"
},
{
"value": "AR.5",
"label": "Servicio de transporte ferroviario/automotor"
},
{
"value": "AR.6",
"label": "Servicio de transporte marítimo/fluvial y lacustre"
},
{
"value": "AR.7",
"label": "Servicios auxiliares a la intermediación financiera"
},
{
"value": "AR.8",
"label": "Servicios de administración de consorcios de edificios"
},
{
"value": "AR.9",
"label": "Servicios de alojamiento por hora, temporal, en campings, pensiones, hoteles, hosterías y/o residenciales similares"
},
{
"value": "AR.10",
"label": "Servicios de asociaciones"
},
{
"value": "AR.11",
"label": "Servicios de centros de estética, spa y similares"
},
{
"value": "AR.12",
"label": "Servicios de comidas \"fast food\", comida para llevar, helados, realizadas por/para vendedores ambulantes o para empresas y eventos"
},
{
"value": "AR.13",
"label": "Servicios de consorcios de edificios"
},
{
"value": "AR.14",
"label": "Servicios de cooperativas cuando realizan varias actividades"
},
{
"value": "AR.15",
"label": "Servicios de desarrollo de software y/o portales web"
},
{
"value": "AR.16",
"label": "Servicios de emergencias y traslados"
},
{
"value": "AR.17",
"label": "Servicios de enseñanza"
},
{
"value": "AR.18",
"label": "Servicios de entretenimiento"
},
{
"value": "AR.19",
"label": "Servicios de financiación y actividades financieras, o fondos y sociedades de inversión y entidades financieras similares"
},
{
"value": "AR.20",
"label": "Servicios de gestión de fondos a cambio de una retribución o por contratación"
},
{
"value": "AR.21",
"label": "Servicios de intermediación financiera realizada por financieras, sociedades de ahorro y préstamo, o cajas de crédito"
},
{
"value": "AR.22",
"label": "Servicios de la banca central, minorista, mayorista o de inversion"
},
{
"value": "AR.23",
"label": "Servicios de limpieza de prendas prestado por tintorerías rápidas"
},
{
"value": "AR.24",
"label": "Servicios de mudanza"
},
{
"value": "AR.25",
"label": "Servicios de mutuales, excepto mutuales de salud y financieras"
},
{
"value": "AR.26",
"label": "Servicios de organización de convenciones y exposiciones comerciales, excepto culturales y deportivos"
},
{
"value": "AR.27",
"label": "Servicios de organización, dirección y gestión de prácticas deportivas en clubes, espectáculos deportivos"
},
{
"value": "AR.28",
"label": "Servicios de organizaciones empresariales y de empleadores, o profesionales"
},
{
"value": "AR.29",
"label": "Servicios de organizaciones políticas"
},
{
"value": "AR.30",
"label": "Servicios de organizaciones religiosas"
},
{
"value": "AR.31",
"label": "Servicios de organizaciones y órganos extraterritoriales"
},
{
"value": "AR.32",
"label": "Servicios de parques de diversiones y parques temáticos"
},
{
"value": "AR.33",
"label": "Servicios de peluquería o tratamientos de belleza"
},
{
"value": "AR.34",
"label": "Servicios de producción de espectáculos artísticos, teatrales y musicales"
},
{
"value": "AR.35",
"label": "Servicios de restaurantes, cantinas y/o bares"
},
{
"value": "AR.36",
"label": "Servicios de salones de juegos"
},
{
"value": "AR.37",
"label": "Servicios de seguridad e investigación"
},
{
"value": "AR.38",
"label": "Servicios de seguros de salud, vida o patrimoniales excepto los de las aseguradoras de riesgo de trabajo (ART)"
},
{
"value": "AR.39",
"label": "Servicios de sindicatos"
},
{
"value": "AR.40",
"label": "Servicios empresariales"
},
{
"value": "AR.41",
"label": "Servicios inmobiliarios realizados por cuenta propia, con bienes urbanos/rurales propios o arrendados"
},
{
"value": "AR.42",
"label": "Servicios jurídicos"
},
{
"value": "AR.43",
"label": "Servicios personales"
},
{
"value": "AR.44",
"label": "Servicios prestados por deportistas y atletas para la realización de prácticas deportivas"
},
{
"value": "AR.45",
"label": "Servicios prestados por profesionales y técnicos para la realización de prácticas deportivas"
},
{
"value": "AR.46",
"label": "Servicios relacionados a activos virtuales y/o criptominería"
},
{
"value": "AR.47",
"label": "Servicios relacionados a la construcción, reforma y/o reparación de edificios, obras relacionadas al transporte y/o redes de servicios públicos"
},
{
"value": "AR.48",
"label": "Servicios relacionados a la fabricación d productos químicos, medicamentos de uso humano y productos de uso farmacéutico"
},
{
"value": "AR.49",
"label": "Servicios relacionados a la minería, metales preciosos y no ferrosos"
},
{
"value": "AR.50",
"label": "Servicios relacionados a los reaseguros"
},
{
"value": "AR.51",
"label": "Servicios relacionados a obras sociales"
},
{
"value": "AR.52",
"label": "Servicios relacionados al arrendamiento y gestión de bienes intangibles no financieros"
},
{
"value": "AR.53",
"label": "Servicios relacionados al procesamiento/ hospedaje de datos"
},
{
"value": "AR.54",
"label": "Servicios relacionados con juegos de azar y apuestas"
},
{
"value": "AR.55",
"label": "Venta al por mayor en comisión o consignación de madera y materiales para la construcción"
},
{
"value": "AR.56",
"label": "Venta al por mayor en comisión o consignación de maquinaria, equipo profesional industrial y comercial, embarcaciones y aeronaves"
},
{
"value": "AR.57",
"label": "Venta al por mayor en comisión o consignación de alimentos, bebidas y tabaco"
},
{
"value": "AR.58",
"label": "Venta al por mayor en comisión o consignación de combustibles"
},
{
"value": "AR.59",
"label": "Venta al por mayor en comisión o consignación de papel, cartón, libros, revistas, diarios, materiales de embalaje y artículos de librería"
},
{
"value": "AR.60",
"label": "Venta al por mayor en comisión o consignación de productos agrícolas y/o pecuarios"
},
{
"value": "AR.61",
"label": "Venta al por menor de productos alimenticios en comercios especializados"
},
{
"value": "AR.62",
"label": "Venta al por menor no realizada en establecimientos"
},
{
"value": "AR.63",
"label": "Venta, mantenimiento y/o reparación de vehículos automotores/motocicletas nuevos o al por mayor de partes, piezas y accesorios"
},
{
"value": "AR.64",
"label": "Otro"
}
]
}
]
}