SIsilverflow
Create Recurring

Create MIT Funding Charge

Create a new funding charge that was initiated by the merchant, without the presence of the cardholder.

For more information on use-cases, see here.

Mastercard support is <a class="experimental-tag-link" href="https://docs.silverflow.com/guides/api-lifecycle#tag/EXPERIMENTAL-Tag"><span class="tag experimental-tag">EXPERIMENTAL</span></a>.

Visa DMS support is <a class="experimental-tag-link" href="https://docs.silverflow.com/guides/api-lifecycle#tag/EXPERIMENTAL-Tag"><span class="tag experimental-tag">EXPERIMENTAL</span></a>.

Requires the charges:CreateMitFunding permission.

post/charges/mitFunding

Request

Headers

Idempotency-Keystring

This key is used to deduplicate requests that are retried. For more information see the section on Idempotency.

Example:28gKCluIEKp8jVboUyr2

Request body

localTransactionDateTimestring iso-8601-date-time

Date and time of the transaction in the local timezone.

transactionType'cryptocurrency' | 'central-bank-digital-currency' | 'stablecoin' | 'blockchain-native-coin' | 'non-fungible-token'

In case of a special transaction type, this allows you to specify which one. <a class="experimental-tag-link" href="https://docs.silverflow.com/guides/api-lifecycle#tag/EXPERIMENTAL-Tag"><span class="tag experimental-tag">EXPERIMENTAL</span></a>

  • cryptocurrency: A transaction involving the purchasing of cryptocurrencies. Use this for Visa only if specific type of digital asset cannot be determined. Use this for Mastercard only when fundingType is account-to-account. <span class="tag network-tag visa-tag">VISA</span><span class="tag network-tag mastercard-tag">MASTERCARD</span>
  • central-bank-digital-currency: A transaction involving purchase of a Central Bank Digital Currency (CBDC). <span class="tag network-tag visa-tag">VISA</span>
  • stablecoin: A transaction involving purchase of stablecoins. <span class="tag network-tag visa-tag">VISA</span>
  • blockchain-native-coin: A transaction involving purchase of a non fiat backed blockchain coin. <span class="tag network-tag visa-tag">VISA</span>
  • non-fungible-token: A transaction involving purchase of a Non Fungible Token (NFT). <span class="tag network-tag visa-tag">VISA</span>
transactionReferencestring

Unique ID assigned by the merchant or payment service provider for the transaction. Used to identify the transaction.

purposeOfPaymentstring

A code that describes the purpose of payment to classify and report the nature and purpose of the transaction. Refer to Visa documentation for country specific requirements for this field.

clearingMode'auto' | 'manual'

The clearing method for the charge.

  • auto: The charge is cleared automatically as soon as possible. To delay clearing, provide a clearAfter timestamp.
  • manual: The charge must be manually cleared later.
clearAfterstring iso-8601-date-time

If provided, clearing will not occur before this point in time. If no timezone is included, it is assumed to be UTC. The value may be at most 6 months in the future from when the charge was created.

riskAssessmentKeystring

Key that was returned by the transaction risk assessment.

allowPartialApprovalboolean

Indicates whether to allow partial approvals for this charge. If set to true the charge's and the authorization action's amount field will contain the approved amount. It is only implemented for Visa and Mastercard. It will be ignored for other card networks.

Example request

{
  "merchantAcceptorResolver": {
    "merchantAcceptorKey": "mac-1eOdAHhgstYTUhlphPFf"
  },
  "card": {
    "number": "4761070000000905",
    "cvc": "123",
    "holderName": "Joe Cardholder"
  },
  "amount": {
    "value": 2599,
    "currency": "EUR"
  },
  "initialTransactionReferences": {
    "initialTraceId": "MCSPMLCC30807",
    "transactionLinkId": "qtQRrYlsSvSecPJDBzrzYA"
  },
  "threeDsAuthenticationResult": {
    "authenticationValue": "kANBCCDDYJYjadADpka8KoQMqS",
    "directoryServerTransId": "5340af8a-5505-4bf6-abcd-123412341234",
    "eci": "05"
  },
  "transactionReference": "Dz3dIzE74EfH1HeTInyE",
  "receiver": {
    "organizationName": "Name",
    "firstName": "Name",
    "middleName": "Name",
    "lastName": "Name",
    "accountNumber": "5286940020000007",
    "address": {
      "countryCode": {
        "alpha3": "NLD"
      },
      "stateOrProvince": "NH",
      "city": "Amsterdam",
      "line1": "Langtown Road",
      "line2": "4200",
      "postalCode": "1234BC"
    }
  },
  "sender": {
    "organizationName": "Name",
    "firstName": "Name",
    "middleName": "Name",
    "lastName": "Name",
    "accountNumber": "5286940020000007",
    "address": {
      "countryCode": {
        "alpha3": "NLD"
      },
      "stateOrProvince": "NH",
      "city": "Amsterdam",
      "line1": "Langtown Road",
      "line2": "4200",
      "postalCode": "1234BC"
    },
    "nationality": {
      "alpha3": "NLD"
    }
  },
  "riskAssessmentKey": "rak-1e1dAHhgstYTUhlphPzZ",
  "foreignRetailer": {
    "amount": 1000
  },
  "subMerchant": {
    "id": "SUB123456",
    "address": {
      "countryCode": {
        "alpha3": "NLD"
      },
      "stateOrProvince": "NH",
      "city": "Amsterdam",
      "line1": "Langtown Road",
      "line2": "4200",
      "postalCode": "1234BC"
    }
  }
}

Response

The created MIT funding charge

keystring required

Uniquely identifies a charge.

localTransactionDateTimestring iso-8601-date-time required

Date and time of the transaction in the local timezone.

transactionType'cryptocurrency' | 'central-bank-digital-currency' | 'stablecoin' | 'blockchain-native-coin' | 'non-fungible-token'

In case of a special transaction type, this allows you to specify which one. <a class="experimental-tag-link" href="https://docs.silverflow.com/guides/api-lifecycle#tag/EXPERIMENTAL-Tag"><span class="tag experimental-tag">EXPERIMENTAL</span></a>

  • cryptocurrency: A transaction involving the purchasing of cryptocurrencies. Use this for Visa only if specific type of digital asset cannot be determined. Use this for Mastercard only when fundingType is account-to-account. <span class="tag network-tag visa-tag">VISA</span><span class="tag network-tag mastercard-tag">MASTERCARD</span>
  • central-bank-digital-currency: A transaction involving purchase of a Central Bank Digital Currency (CBDC). <span class="tag network-tag visa-tag">VISA</span>
  • stablecoin: A transaction involving purchase of stablecoins. <span class="tag network-tag visa-tag">VISA</span>
  • blockchain-native-coin: A transaction involving purchase of a non fiat backed blockchain coin. <span class="tag network-tag visa-tag">VISA</span>
  • non-fungible-token: A transaction involving purchase of a Non Fungible Token (NFT). <span class="tag network-tag visa-tag">VISA</span>
transactionReferencestring

Unique ID assigned by the merchant or payment service provider for the transaction. Used to identify the transaction.

fraudLiability'acquirer' | 'issuer' required

Which party is liable in case of fraud.

purposeOfPaymentstring

A code that describes the purpose of payment to classify and report the nature and purpose of the transaction. Refer to Visa documentation for country specific requirements for this field.

clearingMode'none' | 'auto' | 'manual'

The clearing mode of the charge.

clearAfterstring iso-8601-date-time

If provided, clearing will not occur before this point in time. If no timezone is included, it is assumed to be UTC. The value may be at most 6 months in the future from when the charge was created.

allowPartialApprovalboolean

Indicates whether to allow partial approvals for this charge. If set to true the charge's and the authorization action's amount field will contain the approved amount. It is only implemented for Visa and Mastercard. It will be ignored for other card networks.

createdstring iso-8601-date-time required

The date and time this object was created

lastModifiedstring iso-8601-date-time

The date and time this object was last modified

versioninteger required

The version of this object

Example response

{
  "key": "chg-1e1dAHhgstYTUhlphPzZ",
  "merchantAcceptorRef": {
    "key": "mac-1eOdAHhgstYTUhlphPFf",
    "version": 1
  },
  "amount": {
    "value": 2599,
    "currency": "EUR"
  },
  "transactionReference": "Dz3dIzE74EfH1HeTInyE",
  "receiver": {
    "organizationName": "Name",
    "firstName": "Name",
    "middleName": "Name",
    "lastName": "Name",
    "accountNumber": "************0007",
    "address": {
      "countryCode": {
        "alpha3": "NLD",
        "alpha2": "NL",
        "numeric": "528"
      },
      "stateOrProvince": "NH",
      "city": "Amsterdam",
      "line1": "Langtown Road",
      "line2": "4200",
      "postalCode": "1234BC"
    }
  },
  "sender": {
    "organizationName": "Name",
    "firstName": "Name",
    "middleName": "Name",
    "lastName": "Name",
    "accountNumber": "************0007",
    "address": {
      "countryCode": {
        "alpha3": "NLD",
        "alpha2": "NL",
        "numeric": "528"
      },
      "stateOrProvince": "NH",
      "city": "Amsterdam",
      "line1": "Langtown Road",
      "line2": "4200",
      "postalCode": "1234BC"
    },
    "nationality": {
      "alpha3": "NLD",
      "alpha2": "NL",
      "numeric": "528"
    }
  },
  "status": {
    "authentication": "authenticated",
    "authorization": "approved",
    "clearing": "pending"
  },
  "authentication": {
    "sca": {
      "result": {
        "directoryServerTransId": "5340af8a-5505-4bf6-abcd-123412341234"
      }
    }
  },
  "authorizationIsoFields": {
    "responseCode": "00",
    "responseCodeDescription": "Approved",
    "authorizationCode": "4A4316",
    "systemTraceAuditNumber": "123456",
    "retrievalReferenceNumber": "131608123456",
    "networkSpecificFields": {
      "cvcResult": "Y",
      "avsResult": "Y"
    }
  },
  "foreignRetailer": {
    "amount": 1000
  },
  "subMerchant": {
    "id": "SUB123456",
    "address": {
      "countryCode": {
        "alpha3": "NLD",
        "alpha2": "NL",
        "numeric": "528"
      },
      "stateOrProvince": "NH",
      "city": "Amsterdam",
      "line1": "Langtown Road",
      "line2": "4200",
      "postalCode": "1234BC"
    }
  },
  "version": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.