AT&T DevEx

MVNX API

Version 4.0.0 (latest)
  • Contact Us

    • Adjust Balance

    Version 4.0.0
    download iconDownload spec

    Endpoint

    POST
    https://serverRoot/tmf-api/prepayBalanceManagement/v4/adjustBalance

    This operation creates an AdjustBalance entity. (TMF 654)

    arrowSecurity

    oauth2

    Get a JWT Token from AT&T's Azure AD
    x-amf-settings:
    securedBy:
    authorizationCode:
    scopes:
    tokenUrl:https://login.microsoftonline.com/xxxxxxxxxx/oauth2/v2.0/token
    authorizationUrl:https://login.microsoftonline.com/xxxxxxxxxx/oauth2/v2.0/token
    x-amf-describedBy:
    headers:
    Authorization:
    responses:
    200:
    body:
    application/json:
    properties:
    token_type:
    default:Bearer
    example:Bearer
    expires_in:
    format:int
    access_token:
    example:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
    ext_expires_in:
    format:int
    400:
    body:
    application/json:
    properties:
    error:
    example:unauthorized_client
    trace_id:
    example:b82bea2f-5ee3-48a4-9774-4143176a6900
    timestamp:
    example:2021-06-30 21:12:34Z
    error_uri:
    example:https://login.microsoftonline.com/error?code=700016
    error_codes:
    items:
    format:int
    correlation_id:
    example:b57403ef-e775-49f6-b40f-009ba759c301
    error_description:
    example:AADSTS700016: Application with identifier '6bb2748d-d916-4534-9145-ee8f598d2e01' was not found in the directory 'e741d71c-c6b6-47b0-803c-0f3b32b07556'. This can happen if the application has not been installed by the administrator of the tenant or consented to by any user in the tenant. You may have sent your authentication request to the wrong tenant.\r\nTrace ID: b82bea2f-5ee3-48a4-9774-4143176a6900\r\nCorrelation ID: b57403ef-e775-49f6-b40f-009ba759c301\r\nTimestamp: 2021-06-30 21:12:34Z
    arrowRequest

    Header Parameters

                Body Parameters

                  Responses

                  Success

                  arrowBody

                  application/json

                    REQUEST

                    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
                    curl --request POST \
     --url https://serverroot/tmf-api/prepayBalanceManagement/v4/adjustBalance \
     --header 'Accept: string' \
     --header 'Authorization: string' \
     --header 'Content-Length: integer' \
     --header 'X-ATT-ClientId: string' \
     --header 'X-ATT-ConversationId: string' \
     --header 'X-ATT-CorrelationId: string' \
     --header 'content-type: application/json' \
     --data '
{
  "CreateAdjustmentRequest": {
    "value": {
      "@type": "ResellerMobileLineAdjustment",
      "amount": {
        "units": "USD",
        "amount": 10
      },
      "usageType": "monetary",
      "adjustType": "ADD",
      "logicalResource": {
        "id": "9992220006",
        "@type": "MSISDN",
        "value": "9992220006"
      },
      "adjustmenttypecode": "960"
    }
  },
  "CreateServiceAdjustmentRequest": {
    "value": {
      "@type": "ResellerMobileLineServiceAdjustment",
      "amount": {
        "units": "minutes",
        "amount": 0
      },
      "usageType": "text",
      "adjustType": "SET_REFILLAMOUNT",
      "servicetype": "DYN_DOM_VOICE",
      "logicalResource": {
        "id": "9992220006",
        "@type": "MSISDN",
        "value": "9992220006"
      }
    }
  }
}
'

                    RESPONSE

                    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
                    {
  "CreateAdjustmentResponse": {
    "value": {
      "@type": "ResellerMobileLineAdjustment",
      "amount": {
        "units": "USD",
        "amount": 10
      },
      "status": "confirmed",
      "usageType": "monetary",
      "adjustType": "credit",
      "impactedBucket": [
        {
          "amountAfter": {
            "amount": 40,
            "units": "USD"
          },
          "item": []
        }
      ],
      "logicalResource": {
        "id": "9992220006",
        "@type": "MSISDN",
        "value": "9992220006"
      },
      "adjustmenttypecode": "960"
    }
  },
  "CreateServiceAdjustmentResponse": {
    "value": {
      "@type": "ResellerMobileLineServiceAdjustment",
      "amount": {
        "units": "minutes",
        "amount": 0
      },
      "status": "confirmed",
      "usageType": "text",
      "adjustType": "SET_REFILLAMOUNT",
      "servicetype": "DYN_DOM_VOICE",
      "logicalResource": {
        "id": "9992220006",
        "@type": "MSISDN",
        "value": "9992220006"
      }
    }
  }
}