cisco-cvp-ux icon

cisco-cvp-ux

(0 reviews)

Create PaymentMethod TMF670 POST

[POST] Towards ARIA and Salesforce

This operation create a paymentMethod entity for customer.

Request

URL

http://[host]:[port]/cisco-cvp-ux/v1/{businessId}/paymentMethod

Common Parameters
Base URI parameters and headers are common to all the resources as part of payment-methods Biz API, listed below with details.

Base URI Parameter

NameTypeM/ODescription
businessIdstringMBusiness unit identifier.
Example: PR

Query Parameter

NameTypeM/ODescription
MSISDNstringOPhone Number of the customer. Example: 17879697922

Headers

NameTypeM/ODescription
X-Correlation-IDstringMThis is a unique identifier for the current call chain that can be used to tie together log entries on multiple layers.
Example: 644e1dd7-2a7f-18fb-b8ed-ed78c3F92c2b
lobstringMThe Line of Business Identifier currently available are: FIXED, POSTPAID or PREPAID
channelIdstringOChannel to identify the business group. Ex: ivrB2C

Security Headers

NameTypeM/ODescription
client_idstringMClient Id value for Client Id Enforcement policy. Environment Specific Value. Eg: 6f0ed16a7b494d76b2d60e05bc3b3332
client_secretstringMClient secret value for Client Id Enforcement policy. Environment Specific Value, eg: e4CD4D43449846aA9D8Cb9c43fAd324a

Body

Request Body for Aria
{
    "id": "PAYMENT_99905",
    "name": "Main credit card",
    "authorizationCode": "AutoPay_Due_15_PR",
    "description": "IVR One Time Payment",
    "@type": "TokenizedCreditCard",
    "account": [
        {
            "id": "ARIATESTING013"
        }
    ],
    "details": {
        "token": "gftvcdb"
    }
}
Request Body for Salesforce
{
    "token": "cGF5bWVudG1ldGhvZF9jY181a25obmtzZg",
    "account": [
        {
            "id": "31516278-31514752",
            "@type": "BillingAccount",
            "relatedParty": [
                {
                    "id": "12401231232",
                    "@type": "msisdn"
                }
            ]
        }
    ],
    "relatedParty": [
        {
            "name": "BrainTreeToken",
            "@type": "paymentGatewayType"
        },
        {
            "@type": "channel",
            "name": "IVR"
        }
    ]
}

Response

Possible response success

This section defines all the possible data structures received by the client and that must be considered satisfactory at the time of responding to the method.

TMF Response for post payment method
Success Response from Aria
{
    "relatedParty": [
        {
            "id": "39167180",
            "@type": "BillcontactRef"
        }
    ],
    "id": "PAYMENT_99905",
    "name": "Main credit card",
    "authorizationCode": "AutoPay_Due_15_PR",
    "description": "IVR One Time Payment",
    "@type": "TokenizedCreditCard",
    "account": [
        {
            "id": "ARIATESTING013"
        }
    ],
    "details": {
        "token": "gftvcdb"
    },
    "contact": [
        {
            "contactName": "Rohit,G,Jose",
            "contactType": "primary",
            "contactMedium": [
                {
                    "mediumType": "PostalAddress",
                    "characteristic": {
                        "city": "Toronto",
                        "street1": "15 Rue des Canards",
                        "street2": "15 Rue des Canards",
                        "postCode": "75014",
                        "country": "CA",
                        "stateOrProvince": "AB",
                        "phoneNumber": "9123746584",
                        "emailAddress": "Annacristal@gmail.com",
                        "faxNumber": "3454354353"
                    }
                }
            ]
        }
    ]
}
Success Response from Salesforce
{
    "description": "payment method create request received"
}
Definitions
nametypedescriptionrequired
idstringUnique Identifier within the server for the payment method.Y
authorizationCodestringAuthorization code retrieved from an external payment gateway that could be used for conciliationY
descriptionstringText describing the contents of the paymentN
namestringScreen name of the paymentN
accountobjectReference to the accounts that are linked to the payment method.. A account may be a party account or a financial account.Y
account.idstringUnique identifier of the accountY
account.namestringName of the accountN
@typestringType of payment methodY
relatedPartyarrayInformation about an associated entity and its role. Account that owns the payment methodN
relatedParty.idstringUnique identifier of the related partyN
relatedParty.@typestringType of partyN
statusstringstatus of the paymentN
detailsobjectDetails of the payment method. This object's type depends on the value of the type fieldN
details.tokenstringtoken details of a tokenized bank cardY
contactobject ArrayAn individual or an organization used as a contact point for a given account and accessed via some contact medium.N
contact.contactNamestringA displayable name for that contactN
contact.contactTypestringType of contact (primary, secondary...)N
contact.partyRoleTypestringIdentifies what kind of party role type is linked to the contact (a account manager...)N
contact.contactMediumobject ArrayIndicates the contact medium that could be used to contact the party.N
contact.contactMedium.mediumTypestringType of the contact medium, such as: email address, telephone number, postal addressN
contact.contactMedium.preferredbooleanIf true, indicates that is the preferred contact mediumN
contact.contactMedium.characteristicobjectAny additional characteristic(s) of this contact mediumN
contact.contactMedium.characteristic.citystringCityN
contact.contactMedium.characteristic.contactTypestringThe type of contact, for example; phone number such as mobile, fixed home, fixed office. postal address such as shipping installationN
contact.contactMedium.characteristic.countrystringN
contact.contactMedium.characteristic.emailAddressstringFull email address in standard formatN
contact.contactMedium.characteristic.faxNumberstringThe fax number of the contactN
contact.contactMedium.characteristic.phoneNumberstringThe primary phone number of the contactN
contact.contactMedium.characteristic.postCodestringPostcodeN
contact.contactMedium.characteristic.socialNetworkIdstringIdentifier as a member of a social networkN
contact.contactMedium.characteristic.stateOrProvincestringState or provinceN
contact.contactMedium.characteristic.street1stringDescribes the streetN
contact.contactMedium.characteristic.street2stringComplementary street descriptionN
contact.contactMedium.characteristic..@baseTypestringWhen sub-classing, this defines the super-classN
contact.contactMedium.characteristic..@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
contact.contactMedium.characteristic..@typestringWhen sub-classing, this defines the sub-class entity nameN
contact.contactMedium.validForaccountRelationship.validForN
contact.contactMedium.@baseTypestringWhen sub-classing, this defines the super-classN
contact.contactMedium.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
contact.contactMedium.@typestringWhen sub-classing, this defines the sub-class entity nameN
contact.relatedPartyrelatedPartyN
contact.validForaccountRelationship.validForN
contact.@baseTypestringWhen sub-classing, this defines the super-classN
contact.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
contact.@typestringWhen sub-classing, this defines the sub-class entity nameN

Reviews