{"_id":"59dfa5868b51880010b74aff","category":{"_id":"59dfa5828b51880010b74ac2","version":"59dfa5828b51880010b74ab6","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:20:51.519Z","from_sync":false,"order":11,"slug":"resources","title":"JSON Objects"},"project":"57336fd5a6a9c40e00e13a0b","parentDoc":null,"user":"560d5913af97231900938124","version":{"_id":"59dfa5828b51880010b74ab6","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-10-12T17:25:22.850Z","releaseDate":"2017-10-12T17:25:22.850Z","categories":["59dfa5828b51880010b74ab7","59dfa5828b51880010b74ab8","59dfa5828b51880010b74ab9","59dfa5828b51880010b74aba","59dfa5828b51880010b74abb","59dfa5828b51880010b74abc","59dfa5828b51880010b74abd","59dfa5828b51880010b74abe","59dfa5828b51880010b74abf","59dfa5828b51880010b74ac0","59dfa5828b51880010b74ac1","59dfa5828b51880010b74ac2","59dfa5828b51880010b74ac3","59dfa5828b51880010b74ac4","59dfa5828b51880010b74ac5"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.23 Release","version_clean":"8976.0.0-JSON","version":"8976-JSON"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-28T19:25:37.058Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"h-3\": \"Description\",\n    \"0-0\": \"`amount`\",\n    \"0-1\": \"*decimal*\",\n    \"0-2\": \"*Create Merchant-Managed Subscription:*\\n**Required** for SEPA Direct Debit; optional otherwise\\n\\n*Create Merchant-Managed Subscription Charge:* \\n**Required**\",\n    \"1-0\": \"`currency`\",\n    \"1-1\": \"*string*\",\n    \"1-2\": \"**Required**\",\n    \"0-3\": \"Charge amount.\",\n    \"1-3\": \"Currency code (ISO 4217) of the amount to be charged. See [Currency codes](/docs/currency-codes).\",\n    \"2-0\": \"`vaultedShopperId`\",\n    \"2-1\": \"*integer*\",\n    \"2-2\": \"*Create Merchant-Managed Subscription:*\\nOptional; do not include if sending `payerInfo`\",\n    \"2-3\": \"ID of an existing vaulted shopper.\",\n    \"3-0\": \"`payerInfo`\",\n    \"3-1\": \"*object*\",\n    \"3-2\": \"*Create Merchant-Managed Subscription:*\\nOptional; do not include if sending `vaultedShopperId`\",\n    \"3-3\": \"Contains [payerInfo](doc:payer-info) properties.\",\n    \"4-0\": \"`paymentSource`\",\n    \"4-1\": \"*object*\",\n    \"4-2\": \"*Create Merchant-Managed Subscription:*\\n**Required** for `payerInfo`; optional for `vaultedShopperId`\",\n    \"4-3\": \"Contains [paymentSource](doc:payment-source) properties.\",\n    \"5-0\": \"`softDescriptor`\",\n    \"5-1\": \"*string*\",\n    \"5-2\": \"*Create Merchant-Managed Subscription:*\\nOptional\",\n    \"5-3\": \"Description of the transaction, which appears on the shopper's bank statement. Maximum 20 characters.\",\n    \"6-0\": \"`descriptorPhoneNumber`\",\n    \"6-1\": \"*string*\",\n    \"6-2\": \"*Create Merchant-Managed Subscription:*\\nOptional\",\n    \"6-3\": \"Merchant's support phone number that will appear on the shopper's bank statement. Maximum 20 characters.\",\n    \"7-0\": \"`authorizedByShopper`\",\n    \"7-1\": \"*boolean*\",\n    \"7-2\": \"*Create Merchant-Managed Subscription:*\\n**Required** for SEPA Direct Debit\",\n    \"7-3\": \"Value must be **true**.\\n\\nPass this parameter to indicate that you have obtained the shopper's [mandate acceptance](/v1.0/docs/sepa-direct-debit#section-step-1-collect-a-mandate-acceptance-from-your-shopper).\",\n    \"8-0\": \"`transactionFraudInfo`\",\n    \"8-1\": \"*object*\",\n    \"8-2\": \"*Create Merchant-Managed Subscription:*\\nOptional\",\n    \"8-3\": \"Contains [transactionFraudInfo](doc:transaction-fraud-info) properties.\",\n    \"9-0\": \"`chargeInfo`\",\n    \"9-1\": \"*object*\",\n    \"9-2\": \"*Create Merchant-Managed Subscription Charge:*\\nOptional\",\n    \"9-3\": \"Contains [chargeInfo](doc:charge-info) properties.\"\n  },\n  \"cols\": 4,\n  \"rows\": 10\n}\n[/block]\n\n###Response\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"h-3\": \"Description\",\n    \"h-4\": \"Description\",\n    \"9-0\": \"`paymentSource`\",\n    \"9-1\": \"*object*\",\n    \"9-3\": \"Container of [payment-source](doc:payment-source) properties.\",\n    \"9-2\": \"See [paymentSource](doc:payment-source).\",\n    \"10-0\": \"`chargeInfo`\",\n    \"10-2\": \"See [chargeInfo](doc:charge-info).\",\n    \"10-3\": \"ID of an existing vaulted shopper.\",\n    \"10-1\": \"*object*\",\n    \"1-0\": \"`subscriptionId`\",\n    \"1-3\": \"\",\n    \"1-1\": \"*integer*\",\n    \"1-2\": \"BlueSnap identifier for the subscription.\",\n    \"4-0\": \"`transactionId`\",\n    \"4-1\": \"*integer*\",\n    \"4-2\": \"BlueSnap identifier for the transaction.\",\n    \"5-0\": \"`transactionDate`\",\n    \"5-1\": \"*string*\",\n    \"5-2\": \"Date (yyyy-mm-dd) of the transaction.\\n\\nFor example: `\\\"2017-07-21\\\"`\",\n    \"6-0\": \"`amount`\",\n    \"6-1\": \"*decimal*\",\n    \"6-2\": \"Charge amount.\",\n    \"7-0\": \"`currency`\",\n    \"7-2\": \"Currency code (ISO 4217) of the charge. See [Currency codes](/v1.0/docs/currency-codes).\",\n    \"7-1\": \"*string*\",\n    \"8-0\": \"`softDescriptor`\",\n    \"8-1\": \"*string*\",\n    \"8-2\": \"Description of the transaction, which appears on the shopper's credit card statement.\",\n    \"0-0\": \"`chargeId`\",\n    \"0-1\": \"*integer*\",\n    \"0-2\": \"BlueSnap identifier for the charge.\",\n    \"2-0\": \"`planId`\",\n    \"2-1\": \"*integer*\",\n    \"2-2\": \"BlueSnap identifier for the billing plan.\",\n    \"3-0\": \"`vaultedShopperId`\",\n    \"3-1\": \"*integer*\",\n    \"3-2\": \"ID of the vaulted shopper.\",\n    \"11-0\": \"`processingInfo`\",\n    \"11-1\": \"*object*\",\n    \"11-2\": \"See [processingInfo](doc:processing-info).\",\n    \"13-0\": \"`refunds`\",\n    \"13-1\": \"*object*\",\n    \"13-2\": \"See [refunds](doc:refunds).\",\n    \"12-0\": \"`fraudResultInfo`\",\n    \"12-1\": \"*object*\",\n    \"12-2\": \"See [fraudResultInfo](doc:fraud-result-info).\"\n  },\n  \"cols\": 3,\n  \"rows\": 14\n}\n[/block]","excerpt":"Contains information about a specific recurring subscription charge","slug":"charge","type":"basic","title":"charge"}

charge

Contains information about a specific recurring subscription charge

Request

Property Name
Type
Required
Description

amount

decimal

Create Merchant-Managed Subscription:
Required for SEPA Direct Debit; optional otherwise

Create Merchant-Managed Subscription Charge:
Required

Charge amount.

currency

string

Required

Currency code (ISO 4217) of the amount to be charged. See Currency codes.

vaultedShopperId

integer

Create Merchant-Managed Subscription:
Optional; do not include if sending payerInfo

ID of an existing vaulted shopper.

payerInfo

object

Create Merchant-Managed Subscription:
Optional; do not include if sending vaultedShopperId

Contains payerInfo properties.

paymentSource

object

Create Merchant-Managed Subscription:
Required for payerInfo; optional for vaultedShopperId

Contains paymentSource properties.

softDescriptor

string

Create Merchant-Managed Subscription:
Optional

Description of the transaction, which appears on the shopper's bank statement. Maximum 20 characters.

descriptorPhoneNumber

string

Create Merchant-Managed Subscription:
Optional

Merchant's support phone number that will appear on the shopper's bank statement. Maximum 20 characters.

authorizedByShopper

boolean

Create Merchant-Managed Subscription:
Required for SEPA Direct Debit

Value must be true.

Pass this parameter to indicate that you have obtained the shopper's mandate acceptance.

transactionFraudInfo

object

Create Merchant-Managed Subscription:
Optional

Contains transactionFraudInfo properties.

chargeInfo

object

Create Merchant-Managed Subscription Charge:
Optional

Contains chargeInfo properties.

Response

Property Name
Type
Required

chargeId

integer

BlueSnap identifier for the charge.

subscriptionId

integer

BlueSnap identifier for the subscription.

planId

integer

BlueSnap identifier for the billing plan.

vaultedShopperId

integer

ID of the vaulted shopper.

transactionId

integer

BlueSnap identifier for the transaction.

transactionDate

string

Date (yyyy-mm-dd) of the transaction.

For example: "2017-07-21"

amount

decimal

Charge amount.

currency

string

Currency code (ISO 4217) of the charge. See Currency codes.

softDescriptor

string

Description of the transaction, which appears on the shopper's credit card statement.

paymentSource

object

chargeInfo

object

processingInfo

object

fraudResultInfo

object

refunds

object

See refunds.