Tikin · Docs
API ReferenceMoneyRecargas (Tikin)

Crear una recarga por transferencia

POST
/v1/payins

Crea instrucciones y una referencia propia; no acredita saldo. amountRaw es el importe bruto esperado del abono bancario, en centavos de COPM. La comisión y el importe real se fijan al verificar el abono. Una repetición idéntica devuelve 200; otro pedido con la misma llave devuelve 409.

Authorization

productSession
AuthorizationBearer <token>

Sesión del usuario del producto Tikin, con headers Tenant y Account; distinta del token de tenant de plataforma.

In: header

Header Parameters

Tikin-Version?string

La versión del contrato a la que anclas este pedido, como fecha YYYY-MM-DD. Rige la última publicada en o antes de esa fecha; sin el header, la más reciente.

Formatdate
Tenant*string
Account*string
Formatuuid
Idempotency-Key*string

Llave estable del pedido, limitada al tenant y a la cuenta. Conserva la misma al reintentar.

Match^[!-~]+$
Length1 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/payins" \  -H "Tenant: string" \  -H "Account: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "tenant": "string",  "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",  "status": "pendiente_comprobante",  "rail": "manual",  "asset": "COPM",  "amount": {    "raw": "string",    "asset": "COPM"  },  "fee": {    "raw": "string",    "asset": "COPM"  },  "expectedAmount": {    "raw": "string",    "asset": "COPM"  },  "instructions": {},  "transferId": "e240f72a-b0bc-4f57-ab86-5b78f1d8ea9b",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}