Billetera

List the holder's accounts (wallet, pockets, savings) #

GET/v1/gateway/wallet/accounts/

• operationId listWalletAccounts
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.accounts.list()

client.accounts.list()

$client->accounts->list()

await client.Accounts.ListAsync()

client.Wallet.Accounts.List(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/accounts/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Create a sub-account (pocket / savings / goal) #

POST/v1/gateway/wallet/accounts/

• operationId createWalletAccount
• Autenticación X-API-Key · scope wallet:accounts
• Idempotency-Key recomendada (el SDK la genera)

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletAccountCreateIn — Create a sub-account (pocket / savings / goal) for the wallet holder.

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.accounts.create_pocket()

client.accounts.createPocket()

$client->accounts->createPocket()

await client.Wallet.Accounts.CreatePocketAsync()

client.Accounts.CreatePocket(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/accounts/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "kind": "pocket",
    "name": "Ahorro vacaciones"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Transfer between the holder's own accounts #

POST/v1/gateway/wallet/accounts/transfer/

• operationId transferBetweenWalletAccounts
• Autenticación X-API-Key · scope wallet:accounts
• Idempotency-Key recomendada (el SDK la genera)

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletTransferIn — Transfer funds between two of the holder’s own accounts.

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.accounts.transfer()

client.accounts.transfer()

$client->accounts->transfer()

await client.Accounts.TransferAsync()

client.Accounts.Transfer(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/accounts/transfer/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "from_account": "acc_main",
    "to_account": "acc_pocket_1",
    "amount": "150000"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Saldo de la billetera del titular #

GET/v1/gateway/wallet/balance/

• operationId getWalletBalance
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.wallet.balance()

client.wallet.balance()

$client->wallet->balance()

await client.Wallet.BalanceAsync()

client.Wallet.Balance(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/balance/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Catálogo de convenios #

GET/v1/gateway/wallet/billers/

• operationId listBillers
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.wallet.bills.billers()

client.wallet.bills.billers()

$client->wallet->bills->billers()

await client.Wallet.Bills.BillersAsync()

client.Wallet.Bills.Billers(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/billers/" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Consultar una factura #

POST/v1/gateway/wallet/bills/inquiry/

• operationId inquireBill
• Autenticación X-API-Key · scope wallet:payments
• Idempotency-Key no aplica

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletBillInquiryIn

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.wallet.bills.inquire()

client.wallet.bills.inquire()

$client->wallet->bills->inquire()

await client.Wallet.Bills.InquireAsync()

client.Wallet.Bills.Inquire(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/bills/inquiry/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "biller_code": "EPM",
    "reference": "123456789"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Pagar una factura #

POST/v1/gateway/wallet/bills/pay/

• operationId payBill
• Autenticación X-API-Key · scope wallet:payments
• Idempotency-Key obligatoria

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletBillPayIn

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.wallet.bills.pay()

client.wallet.bills.pay()

$client->wallet->bills->pay()

await client.Wallet.Bills.PayAsync()

client.Wallet.Bills.Pay(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/bills/pay/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "biller_code": "EPM",
    "reference": "123456789",
    "amount": "3500000"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Historial de pagos de facturas y recargas #

GET/v1/gateway/wallet/bills/payments/

• operationId listBillPayments
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.wallet.bills.list_payments()

client.wallet.bills.listPayments()

$client->wallet->bills->listPayments()

await client.Wallet.Bills.ListPaymentsAsync()

client.Wallet.Bills.ListPayments(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/bills/payments/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Detalle de un pago #

GET/v1/gateway/wallet/bills/payments/{payment_id}/

• operationId getBillPayment
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.wallet.bills.get_payment()

client.wallet.bills.getPayment()

$client->wallet->bills->getPayment()

await client.Wallet.Bills.GetPaymentAsync()

client.Wallet.Bills.GetPayment(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/bills/payments/8c2d0000-0000-4a1b-9c2d-000000000001/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Límites Bre-B del titular #

GET/v1/gateway/wallet/breb/limits/

• operationId getBreBLimits
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.wallet.breb.limits()

client.wallet.breb.limits()

$client->wallet->breb->limits()

await client.Wallet.BreB.LimitsAsync()

client.Wallet.BreB.Limits(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/breb/limits/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Resolver una llave Bre-B #

POST/v1/gateway/wallet/breb/resolve/

• operationId resolveBreBKey
• Autenticación X-API-Key · scope wallet:transfer
• Idempotency-Key no aplica

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletBreBResolveIn

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.wallet.breb.resolve()

client.wallet.breb.resolve()

$client->wallet->breb->resolve()

await client.Wallet.BreB.ResolveAsync()

client.Wallet.BreB.Resolve(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/breb/resolve/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "key_type": "PHONE",
    "value": "3109876543"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Enviar por Bre-B #

POST/v1/gateway/wallet/breb/transfers/

• operationId createBreBTransfer
• Autenticación X-API-Key · scope wallet:transfer
• Idempotency-Key obligatoria

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletTransferIn2 — Envío P2P o Bre-B: solo con el resolution_token del resolve (nunca un id suelto).

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.wallet.breb.transfer()

client.wallet.breb.transfer()

$client->wallet->breb->transfer()

await client.Wallet.BreB.TransferAsync()

client.Wallet.BreB.Transfer(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/breb/transfers/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "resolution_token": "<resolution_token>",
    "amount": "3500000"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

List issued cards (non-sensitive metadata) #

GET/v1/gateway/wallet/cards/

• operationId listWalletCards
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.cards.list()

client.cards.list()

$client->cards->list()

await client.Cards.ListAsync()

client.Cards.List(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/cards/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Issue a card (debit; virtual or physical) #

POST/v1/gateway/wallet/cards/

• operationId issueWalletCard
• Autenticación X-API-Key · scope wallet:cards
• Idempotency-Key recomendada (el SDK la genera)

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletCardIssueIn — Issue a card (debit; virtual or physical) for the wallet holder.

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.cards.issue()

client.cards.issue()

$client->cards->issue()

await client.Wallet.Cards.IssueAsync()

client.Cards.Issue(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/cards/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "form_factor": "virtual"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Change card status (freeze / unfreeze / block) #

POST/v1/gateway/wallet/cards/{card_id}/status/

• operationId setWalletCardStatus
• Autenticación X-API-Key · scope wallet:cards
• Idempotency-Key recomendada (el SDK la genera)

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletCardStatusIn — Change a card’s state (freeze / unfreeze / block).

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.cards.set_status()

client.cards.setStatus()

$client->cards->setStatus()

await client.Cards.SetStatusAsync()

client.Cards.SetStatus(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/cards/card-9/status/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "status": "freeze"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Movements on a card #

GET/v1/gateway/wallet/cards/{card_id}/transactions/

• operationId listWalletCardTransactions
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.cards.transactions()

client.cards.transactions()

$client->cards->transactions()

await client.Cards.TransactionsAsync()

client.Cards.Transactions(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/cards/card-9/transactions/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Execute a currency conversion #

POST/v1/gateway/wallet/fx/convert/

• operationId executeFxConversion
• Autenticación X-API-Key · scope wallet:fx
• Idempotency-Key recomendada (el SDK la genera)

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema FxConvertIn — Execute a currency conversion (moves money — idempotency-key recommended).

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.fx.convert()

client.fx.convert()

$client->fx->convert()

await client.Fx.ConvertAsync()

client.Wallet.FX.Convert(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/fx/convert/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "quote_id": "fxq_abc123",
    "sell_currency": "COP",
    "buy_currency": "USD",
    "amount": "1000000"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Quote a currency conversion #

POST/v1/gateway/wallet/fx/quote/

• operationId quoteFxConversion
• Autenticación X-API-Key · scope wallet:fx
• Idempotency-Key no aplica

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema FxQuoteIn — Request an indicative FX quote (moves no money, not billable).

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.fx.quote()

client.fx.quote()

$client->fx->quote()

await client.Wallet.Fx.QuoteAsync()

client.FX.Quote(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/fx/quote/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "sell_currency": "COP",
    "buy_currency": "USD",
    "amount": "1000000"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Resolver destinatario P2P #

POST/v1/gateway/wallet/p2p/resolve/

• operationId resolveP2PRecipient
• Autenticación X-API-Key · scope wallet:transfer
• Idempotency-Key no aplica

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletResolveP2PIn

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.wallet.p2p.resolve()

client.wallet.p2p.resolve()

$client->wallet->p2p->resolve()

await client.Wallet.P2P.ResolveAsync()

client.Wallet.P2P.Resolve(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/p2p/resolve/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "alias": "3001234567"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Transferir a otro afiliado #

POST/v1/gateway/wallet/p2p/transfers/

• operationId createP2PTransfer
• Autenticación X-API-Key · scope wallet:transfer
• Idempotency-Key obligatoria

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletTransferIn2 — Envío P2P o Bre-B: solo con el resolution_token del resolve (nunca un id suelto).

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.wallet.p2p.transfer()

client.wallet.p2p.transfer()

$client->wallet->p2p->transfer()

await client.Wallet.P2P.TransferAsync()

client.Wallet.P2P.Transfer(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/p2p/transfers/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "resolution_token": "<resolution_token>",
    "amount": "3500000"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Recargar un celular #

POST/v1/gateway/wallet/topups/

• operationId createTopup
• Autenticación X-API-Key · scope wallet:topup
• Idempotency-Key obligatoria

Parámetros

Cuerpo de la petición

Tipo de contenido: application/json · obligatorio

Esquema WalletTopupIn

Acepta campos adicionales (additionalProperties): se reenvían al motor sin cambios.

Respuestas

Ejemplo

client.wallet.topups.create()

client.wallet.topups.create()

$client->wallet->topups->create()

await client.Wallet.Topups.CreateAsync()

client.Wallet.Topups.Create(ctx, …)

curl -X POST "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/topups/" \
  -H "X-API-Key: $COMPENSE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "1032456789",
    "phone_number": "3001234567",
    "carrier": "CLARO",
    "amount": "3500000"
  }'

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Operadores de recarga #

GET/v1/gateway/wallet/topups/operators/

• operationId listTopupOperators
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Respuestas

Ejemplo

client.wallet.topups.operators()

client.wallet.topups.operators()

$client->wallet->topups->operators()

await client.Wallet.Topups.OperatorsAsync()

client.Wallet.Topups.Operators(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/topups/operators/" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Movimientos del titular (paginado, con filtros) #

GET/v1/gateway/wallet/transactions/

• operationId listWalletTransactions
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.wallet.transactions.list()

client.wallet.transactions.list()

$client->wallet->transactions->list()

await client.Wallet.Transactions.ListAsync()

client.Wallet.Transactions.List(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/transactions/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.

Detalle de un movimiento #

GET/v1/gateway/wallet/transactions/{tx_id}/

• operationId getWalletTransaction
• Autenticación X-API-Key · scope wallet:read
• Idempotency-Key no aplica

Parámetros

Respuestas

Ejemplo

client.wallet.transactions.get()

client.wallet.transactions.get()

$client->wallet->transactions->get()

await client.Wallet.Transactions.GetAsync()

client.Wallet.Transactions.Get(ctx, …)

curl "https://sandbox.dev.compense.co/gw/v1/gateway/wallet/transactions/6b1f8c1e-0000-4a1b-9c2d-000000000001/?document=1090123456" \
  -H "X-API-Key: $COMPENSE_API_KEY"

Los métodos de cada SDK salen de su suite de paridad con el contrato. El cURL va contra el sandbox; los valores <campo> son marcadores.