Returns the outcome of a top-up requested with Top-up eSIM.

Request

• Method: POST
• URL: https://api.bnesim.com/v2.0/enterprise/recharge-transaction/get-status
• Content-Type: multipart/form-data
• Authentication: Bearer token required

Parameters

• rechargeTransaction (Required): the recharge_transaction_id returned by Top-up eSIM

Response Fields

• state: what to act on
  • PENDING - still being processed, check again in a few seconds
  • COMPLETED - the data plan was added to the eSIM
  • FAILED - the top-up did not go through; see failure_reason
• status: the detailed internal status (TO_BE_PROCESSED, OK, FAILED, ...)
• recharge_transaction_id, license_cli, iccid, product_id
• created_at, updated_at
• failure_reason: present when state is FAILED

Unknown IDs return HTTP 404 (RECHARGE_TRANSACTION_NOT_FOUND); a top-up that does not belong to your account returns HTTP 403.

Example cURL

curl --request POST \
     --url https://api.bnesim.com/v2.0/enterprise/recharge-transaction/get-status \
     --header "accept: application/json" \
     --header "authorization: Bearer {{bearerToken}}" \
     --header "content-type: multipart/form-data" \
     --form rechargeTransaction={{rechargeTransactionId}}

Important Notes

• Top-ups usually complete within seconds; poll every few seconds while state is PENDING.
• This endpoint is the source of truth, also when you use completion callbacks.