Skip to main content
POST
Create Payins

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key
string

Unique key to ensure idempotent request handling. If a request with the same key was already processed, the cached response is returned.

Body

application/json
preFundAccountId
string
required

The destination custodial account the payin will be credited to.

Example:

"e8d74b2f-86df-43b0-a9d9-72055a6b0432"

method
enum<string>
required
Available options:
PSE,
SPEI,
TRANSFIYA,
POLYGON,
ERC20,
SOLANA,
BSC,
TRON
Example:

"PSE"

amount
number
required
Example:

8000

externalId
string

identifier used to identify your existing payins

Example:

"d00e4f43-2022-42f3-ba1c-dcf4c1dcd934"

metadata
object

Arbitrary object for client use.

Example:

Response

id
string
required
Example:

"e8d74b2f-86df-43b0-a9d9-72055a6b0432"

amount
number
required
Example:

8000

currency
enum<string>
required
Available options:
COP,
MXN,
USDC,
USDT
Example:

"COP"

method
enum<string>
required
Available options:
PSE,
SPEI,
TRANSFIYA,
POLYGON,
ERC20,
SOLANA,
BSC,
TRON
Example:

"PSE"

status
enum<string>
required
Available options:
CREATED,
COMPLETED,
FAILED,
ERROR,
REFUNDED,
KYT_IN_CREATE,
KYT_IN_PENDING,
KYT_IN_PROCESSING,
KYT_IN_COMPLETED,
KYT_IN_FAILED,
CASH_IN_CREATED,
CASH_IN_REQUEST,
CASH_IN_REQUESTED,
CASH_IN_PENDING,
CASH_IN_PROCESSING,
CASH_IN_COMPLETED,
CASH_IN_CANCELED,
CASH_IN_REJECTED,
CASH_IN_FAILED,
CASH_IN_ERROR,
REFUND_CREATE,
REFUND_CREATED,
REFUND_REQUEST,
REFUND_REQUESTED,
REFUND_PENDING,
REFUND_PROCESSING,
REFUND_COMPLETED,
REFUND_FAILED
Example:

"CASH_IN_CREATED"

createdAt
string<date-time>
required
Example:

"2026-04-23T00:38:08.439Z"

updatedAt
string<date-time>
required
Example:

"2026-04-23T00:38:08.439Z"

paymentInfo
string[]

Deposit instructions for the customer to fund the payin: a crypto deposit address/network for crypto methods, or a virtual account for bank rails.

details
string

Notes about issues or observations related to the payin

Example:

"Payment processed successfully"

externalId
string
Example:

"d00e4f43-2022-42f3-ba1c-dcf4c1dcd934"

metadata
object

Arbitrary object provided by the client at payin creation.

Example: