Skip to main content

Create a Payin

Collect funds from a third party (end-user) to be tokenized into stablecoin tokens. The payment link generated is valid for 15 minutes after creation.

POST/v1/payins
curl -X POST 'https://api.minteo.finance/v1/payins' \
-H 'Authorization: Bearer <your-api-key>' \
-H 'Content-Type: application/json' \
-d '{
  "token": "COPM",
  "amount": "127000",
  "destination_wallet_id": "2af83836-43ea-407b-ab4e-9c64ee817b28",
  "purpose": "Top-up on behalf of John Doe",
  "final_url": "https://yoursite.com/payin-completed",
  "payment": {
    "method": "PSE",
    "bank": "BANCO_FALABELLA"
  },
  "third_party": {
    "full_name": "John Doe",
    "legal_identifier_type": "CC",
    "legal_identifier": "1099075610",
    "country_iso": "CO",
    "email": "john@example.com",
    "phone_number": "3001234567"
  }
}'
RESPONSE
{
  "output": {
    "id": "ffb50d6c-09f1-4f08-9b91-cbce466bed52",
    "action": {
      "type": "REDIRECT",
      "redirect_url": "https://api.minteo.finance/v1/payins/redirect/ffb50d6c-09f1-4f08-9b91-cbce466bed52"
    },
    "status": "PENDING",
    "destination_wallet_id": "2af83836-43ea-407b-ab4e-9c64ee817b28",
    "amount": "127000",
    "token": "COPM",
    "purpose": "Top-up on behalf of John Doe",
    "final_url": "https://yoursite.com/payin-completed?payin_id=ffb50d6c-09f1-4f08-9b91-cbce466bed52",
    "payment": {
      "method": "PSE",
      "bank": "BANCO_FALABELLA"
    },
    "third_party": {
      "full_name": "John Doe",
      "legal_identifier_type": "CC",
      "legal_identifier": "1099075610",
      "country_iso": "CO",
      "email": "john@example.com",
      "phone_number": "3001234567"
    }
  },
  "code": "CREATED"
}

Endpoint​

POST/v1/payins

Scope​

payins:create

Request​

Request Body​

tokenstring

The stablecoin token to be used. Currently only COPM (Colombian Pesos) is supported. Must match the destination wallet's token.

amountstring

Amount of funds to collect and tokenize. Max 5,000,000 per transaction. Minimum: 10,000 COP.

paymentpayment

Payment method configuration.

destination_wallet_iduuid

ID of the Customer's wallet to receive the stablecoin tokens.

purposestring

Description of why the payin is being made.

final_urlstring

Your site's URL where Minteo redirects the end-user after payment completes. The Payin ID will be appended as ?payin_id=.... This is not the payment URL — that's returned in the response's action.redirect_url.

third_partythird_party

The end-user completing the payment.

The payment object​

methodstring

Payment method. Currently only PSE (Pagos Seguros En linea) is supported.

bankPSE Banks

The bank for the payin. Must be from the list below.

Available PSE Banks​

View available PSE banks
  • ALIANZA_FIDUCIARIA
  • BANCIEN
  • BANCAMIA
  • BANCO_AGRARIO
  • BANCO_AV_VILLAS
  • BANCO_BBVA
  • BANCO_CAJA_SOCIAL
  • BANCO_COOPERATIVO_COOPCENTRAL
  • BANCO_DAVIVIENDA
  • BANCO_DE_BOGOTA
  • BANCO_DE_OCCIDENTE
  • BANCO_FALABELLA
  • BANCO_FINANDINA
  • BANCO_GNB_SUDAMERIS
  • BANCO_ITAU
  • BANCO_J_P_MORGAN
  • BANCO_MUNDO_MUJER
  • BANCO_PICHINCHA
  • BANCO_POPULAR
  • BANCO_SANTANDER
  • BANCO_SERFINANZA
  • BANCO_UNION
  • BANCOLOMBIA
  • BANCOOMEVA
  • BOLD
  • CFA_COOPERATIVA_FINANCIERA
  • CITIBANK
  • COINK
  • COLTEFINANCIERA
  • CONFIAR_COOPERATIVA_FINANCIERA
  • COTRAFA
  • CREZCAMOS
  • DALE
  • DAVIPLATA
  • DING
  • FINANCIERA_JURISCOOP_SA_COMPANIA_DE_FINANCIAMIENTO
  • GLOBAL66
  • IRIS
  • JFK_COOPERATIVA_FINANCIERA
  • LULO_BANK
  • MOVII
  • NEQUI
  • NU
  • POWWI
  • RAPPIPAY
  • SCOTIABANK_COLPATRIA
  • UALA

The third_party object​

full_namestring

Full name of the third party.

legal_identifier_typestring

Type of legal ID. Valid values: CC (Cedula de Ciudadania), CE (Cedula de Extranjeria), NIT, PP (Passport).

legal_identifierstring

Legal ID number.

country_isostring

ISO 3166-1 alpha-2 country code. Currently only CO (Colombia).

emailstring

Email address.

phone_numberstring

Colombian phone number, 10 digits without country code (e.g. 3001234567). Must be a real, unique number.

Response​

The response includes an action field that indicates what the end-user needs to do next. Currently, the only action type is REDIRECT — you must redirect the end-user to action.redirect_url to complete the payment. After payment, they'll be redirected to your final_url with the Payin ID appended as ?payin_id=....

outputPayin

The Payin object.

codestring

The response status code text.

The action object​

typestring

Action type. Currently only REDIRECT.

redirect_urlstring

URL to redirect the end-user to for payment completion.