Create Merchant-Managed Subscription Charge

If you manage your own subscriptions, the Create Merchant-Managed Subscription Charge request enables you to process recurring charges for a specific subscription. Each charge is associated to the initial subscription based on the subscription ID.

For more information on working with merchant-managed subscriptions, see Merchant-Managed Subscriptions.

Request Content

charge container required, contains the following properties (see charge):

Property	Type	Required
`amount`	decimal	required
`charge-info`	container	optional (see charge-info)
`currency`	string	required
`level-3-data`	container	optional (see level-3-data)
`merchant-transaction-id`	string	optional
`scheduled`	boolean	optional
`tax-reference`	string	optional
`transaction-meta-data`	container	optional (see transaction-meta-data)
`vendors-info`	container	optional (see vendors-info)

Response Details

If successful, the response HTTP status code is 200 OK.
The response body contains the charge resource.

Examples

Request Examples

curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/ondemand/10543419 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<charge xmlns="http://ws.plimus.com">
    <amount>45</amount>
    <currency>USD</currency>
    <merchant-transaction-id>MyUniqueOnDemandSubscription</merchant-transaction-id>
    <tax-reference>048deff0-a285-47e1-bc39-42f79bf0095b</tax-reference>
    <transaction-meta-data>
        <meta-data>
            <meta-key>stateTaxAmount</meta-key>
            <meta-value>2</meta-value>
            <meta-description>State Tax Amount</meta-description>
        </meta-data>
        <meta-data>
            <meta-key>cityTaxAmount</meta-key>
            <meta-value>3</meta-value>
            <meta-description>City Tax Amount</meta-description>
        </meta-data>
    </transaction-meta-data>
</charge>'

curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/ondemand/10543419 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<charge xmlns="http://ws.plimus.com">
    <amount>45</amount>
    <currency>USD</currency>
    <scheduled>true</scheduled>
    <payer-info>
        <first-name>John</first-name>
        <last-name>Doe</last-name>
        <zip>12345</zip>
        <country>us</country>
    </payer-info>
    <payment-source>
        <credit-card-info>
            <credit-card>
                <card-number>4012000033330026</card-number>
                <security-code>111</security-code>
                <expiration-month>05</expiration-month>
                <expiration-year>2023</expiration-year>
            </credit-card>
        </credit-card-info>
    </payment-source>
</charge>'

curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/ondemand/10543419 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<charge xmlns="http://ws.plimus.com">
    <amount>45</amount>
    <currency>USD</currency>
    <merchant-transaction-id>MyUniqueOnDemandSubscription</merchant-transaction-id>
    <vendors-info>
        <vendor-info>
            <vendor-id>10398032</vendor-id>
        </vendor-info>
    </vendors-info>
</charge>'

Response Examples

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<charge xmlns="http://ws.plimus.com">
    <charge-id>6204026</charge-id>
    <subscription-id>10543419</subscription-id>
    <vaulted-shopper-id>22220051</vaulted-shopper-id>
    <transaction-id>1011815941</transaction-id>
    <merchant-transaction-id>MyUniqueOnDemandSubscription</merchant-transaction-id>
    <tax-reference>048deff0-a285-47e1-bc39-42f79bf0095b</tax-reference>
    <transaction-date>2017-10-17</transaction-date>
    <amount>45.00</amount>
    <currency>USD</currency>
    <soft-descriptor>BLS&#x2a;BlueSnap</soft-descriptor>
    <payment-source>
        <credit-card-info>
            <credit-card>
                <card-last-four-digits>0026</card-last-four-digits>
                <card-type>VISA</card-type>
                <card-sub-type>CREDIT</card-sub-type>
                <card-category>CLASSIC</card-category>
                <expiration-month>05</expiration-month>
                <expiration-year>2023</expiration-year>
            </credit-card>
        </credit-card-info>
    </payment-source>
    <charge-info>
        <charge-description>OnDemand Subscription Charge</charge-description>
        <charge-type>RECURRING</charge-type>
    </charge-info>
    <processing-info>
        <processing-status>SUCCESS</processing-status>
        <transaction-region>US</transaction-region>
    </processing-info>
</charge>