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.
See the guide on using merchant-managed subscriptions
For more information on working with merchant-managed subscriptions, see Merchant-Managed Subscriptions.
Send a test request
Go to API Explorer to send a test request to our sandbox environment and receive a response in real time.
Request Content
Send a charge object, with the following:
| Property | Type | Required |
|---|---|---|
amount | decimal | required |
chargeInfo | object | optional (see chargeInfo) |
currency | string | required |
level3Data | object | optional (see level3Data) |
merchantTransactionId | string | optional |
taxReference | string | optional |
transactionMetaData | object | optional (refer to transactionMetaData) |
scheduled | boolean | optional |
vendorsInfo | object | optional (see vendorsInfo) |
Response Details
If successful, the response HTTP status code is 200 OK.
The response body contains the charge object.
Examples
Request Examples
curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/ondemand/10543419 \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 45,
"currency": "USD",
"merchantTransactionId": "MyUniqueOnDemandSubscription",
"taxReference": "048deff0-a285-47e1-bc39-42f79bf0095b",
"transactionMetaData": {
"metaData": [
{
"metaValue": 3,
"metaKey": "StateTaxAmount",
"metaDescription": "State Tax Amount"
},
{
"metaValue": 2,
"metaKey": "CityTaxAmount",
"metaDescription": "City Tax Amount"
}
]
}
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/ondemand/10543419 \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 45,
"currency": "USD",
"scheduled": true,
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"zip": "02453",
"country": "us"
},
"paymentSource": {
"creditCardInfo": {
"creditCard": {
"expirationYear": 2023,
"securityCode": 111,
"expirationMonth": "05",
"cardNumber": 4012000033330026
}
}
}
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/recurring/ondemand/10543419 \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 45,
"currency": "USD",
"merchantTransactionId": "MyUniqueOnDemandSubscription",
"vendorsInfo": {
"vendorInfo": [{ "vendorId": "10398032" }]
}
}'
Response Examples
{
"chargeId": 12949131,
"subscriptionId": 10543419,
"vaultedShopperId": 22194079,
"transactionId": "1015010743",
"merchantTransactionId": "MyUniqueOnDemandSubscription",
"taxReference": "048deff0-a285-47e1-bc39-42f79bf0095b",
"transactionDate": "2017-10-31",
"amount": 45,
"currency": "USD",
"softDescriptor": "default_descriptor",
"paymentSource": {
"creditCardInfo": {
"creditCard": {
"cardLastFourDigits": "0026",
"cardType": "VISA",
"cardSubType": "CREDIT",
"cardCategory": "CLASSIC",
"expirationMonth": "05",
"expirationYear": "2023"
}
}
},
"chargeInfo": {
"chargeDescription": "OnDemand Subscription Charge",
"chargeType": "RECURRING"
},
"processingInfo": {
"processingStatus": "SUCCESS",
"transactionRegion": "US"
}
}
API Explorer
To test out a call, enter an existing subscription ID (e.g. 10543419) in the subscription-id field. This will automatically insert the ID into the request URL. Click Try it! when you're ready to test the request.