Skip to main content
Direct Payment lets you process payins without redirecting the customer to a hosted checkout. Your application collects the required fields and submits them straight to Vita, keeping the user inside your flow.

Integration flow

1

Query available methods

GET /api/businesses/payment_methods/{country} — returns the available payment methods and the required fields for each one.
2

Create the payment order

Use the standard Payins endpoint to create the payment order you’ll process.
3

Process the direct payment

POST /api/businesses/payment_orders/{id}/direct_payment — submits the collected payment data without redirection.

Features

No redirection

The user stays inside your application for the whole flow.

Automatic validation

Required fields and formats are validated server-side with clear error responses.

Multiple methods per country

PSE, Nequi, Bancolombia, cards (TDC), Webpay, and others — depending on destination.

Detailed error handling

Explicit HTTP codes and payloads so your UI can react precisely to each failure.