v1

latestOpenAPI 3.0.32026-07-2485236250.4 KB
Cards/Topup

Executes card topup request

Executes the estimated card topup request

post/api/v1/cards/topup/execute

Request body

device_idstring

DeviceId is the client device identifier forwarded to the underlying provider when present

estimation_idstring required

EstimationId identifies the previously created topup estimation

Example request

{
  "device_id": "device-1234",
  "estimation_id": "00000000-0000-0000-0000-000000000001"
}

Response

OK

idstring required

Identifier of the initiated topup

statusstring required

Status of the topup after initiation

Example response

{
  "id": "00000000-0000-0000-0000-000000000001",
  "status": "pending",
  "three_ds_state": {
    "flow": "frictionless",
    "provider": "checkout",
    "status": "approved",
    "status_reason": "low_risk",
    "url": "https://3ds.example/challenge"
  }
}