Skip to main content
POST
/
v2
/
transactions
/
card
/
payments
Crear pago con tarjeta
curl --request POST \
  --url https://sandbox-rampa.mesadepagos.com/api/v2/transactions/card/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalReference": "ORDER-CARD-1001",
  "amount": 100.5,
  "currency": "BOB",
  "country": "BO",
  "card": {
    "cardType": "001",
    "holderName": "Juan Perez",
    "number": "4111111111111111",
    "expirationMonth": "12",
    "expirationYear": "2028",
    "cvv": "123"
  },
  "customer": {
    "firstName": "Juan",
    "lastName": "Perez",
    "email": "juan.perez@example.com",
    "locality": "La Paz",
    "phoneNumber": "+59171234567",
    "postalCode": "0201"
  },
  "description": "Pago orden 1001"
}
'
{
  "transactionId": "550e8400-e29b-41d4-a716-446655440100",
  "externalReference": "ORDER-CARD-1001",
  "type": "cardPayment",
  "status": "pendingConfirmation",
  "amount": "100.50",
  "currency": "BOB",
  "country": "BO",
  "authorization": {
    "requiresConfirmation": true,
    "confirmationMethod": "otp",
    "expiresAt": "2026-06-02T18:30:00.000Z"
  },
  "message": "Card payment created. Confirmation is required."
}

Authorizations

​
Authorization
string
header
required

JWT obtenido desde /v2/auth/login

Body

application/json

Datos necesarios para iniciar el pago con tarjeta.

​
externalReference
string
required

Referencia externa única enviada por el partner.

Required string length: 1 - 100
Example:

"ORDER-CARD-1001"

​
amount
number
required

Monto fiat a cobrar.

Required range: x >= 0Must be a multiple of 0.01
Example:

100.5

​
currency
enum<string>
required

Moneda fiat del pago.

Available options:
BOB,
USD
Example:

"BOB"

​
country
enum<string>
required

País donde se procesa el pago.

Available options:
BO
Example:

"BO"

​
card
object
required

Datos de la tarjeta usada para iniciar el pago.

​
customer
object
required

Datos del cliente pagador.

​
description
string

Descripción visible para conciliación.

Maximum string length: 200
Example:

"Pago orden 1001"

Response

Pago con tarjeta creado exitosamente.

​
transactionId
string
required

Identificador único de la transacción.

Example:

"550e8400-e29b-41d4-a716-446655440100"

​
externalReference
string
required

Referencia externa enviada por el partner.

Example:

"ORDER-CARD-1001"

​
type
enum<string>
required

Tipo de transacción creada.

Available options:
cardPayment
Example:

"cardPayment"

​
status
enum<string>
required

Estado inicial de la transacción.

Available options:
pendingConfirmation,
processingTransaction,
completedTransaction,
failedTransaction
Example:

"pendingConfirmation"

​
amount
string
required

Monto cobrado.

Example:

"100.50"

​
currency
string
required

Moneda del pago.

Example:

"BOB"

​
country
string
required

Código del país.

Example:

"BO"

​
authorization
object
required

Datos de autorización requeridos para confirmar el pago.

​
message
string
required

Mensaje descriptivo del estado.

Example:

"Card payment created. Confirmation is required."