Integration

WIP: A summary needs to be written for Integration

POST/v3/integration/payment/search

Search Payment entities

Search for Payment Entries

Body parameters

Consumes

The following content type is required: application/json

  • Name
    collate
    Type
    boolean
    Description
    if set to true, use natural sort collation when used with orderBy
  • Name
    limit
    Type
    number
    Description
    the limit on the number of records to return
  • Name
    orderBy
    Type
    one of: any, any
    Description
    the order instructions for the result
  • Name
    params
    Type
    object
    Description
    additonal request specific params
  • Name
    skip
    Type
    number
    Description
    the number of records to skip for a paginated result
  • Name
    where
    Type
    one of: any, any
    Description
    an object to use for filtering the results

Produces

The response content type: application/json

200 Response

  • Name
    data
    Type
    array Required
    Description
    an array of items
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

4xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

5xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST
/v3/integration/payment/search
curl https://api.shopmonkey.cloud/v3/integration/payment/search \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "data": [
    {
      "id": "id",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "orderId": "orderId",
      "payerId": null,
      "statementId": null,
      "recordedDate": null,
      "note": "note",
      "status": "status",
      "paymentType": "paymentType",
      "paymentMode": "paymentMode",
      "transactionType": "transactionType",
      "amountCents": 1,
      "refundedAmountCents": null,
      "refunded": true,
      "refundReason": null,
      "chargeId": null,
      "deposit": true,
      "checkNumber": null,
      "cardType": null,
      "cardDigits": null,
      "cardName": null,
      "cardConfirmation": null,
      "debitCard": true,
      "chargeFromPublicPage": true,
      "payoutId": null,
      "receiptNumber": 1,
      "providerFee": null,
      "surchargeFee": null,
      "transactionalFeeAmountCents": null,
      "disputedPaymentId": null,
      "disputedStatus": null,
      "disputedReason": null,
      "disputedType": null,
      "bulkPaymentId": null,
      "imported": true,
      "interchangeFee": null,
      "duesAndAssessmentsFee": null,
      "statusDetails": null
    }
  ],
  "success": true
}
DELETE/v3/integration/payment/manual/:id

Delete Payment

Delete manual payment

URL parameters

  • Name
    id
    Type
    string Required
    Description
    the id for the object

Produces

The response content type: application/json

200 Response

  • Name
    data
    Type
    object
    Description
  • Name
    success
    Type
    boolean Required
    Description

Properties for data object

  • Name
    id
    Type
    string Required
    Description
    the id for the object

4xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

5xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

DELETE
/v3/integration/payment/manual/:id
curl https://api.shopmonkey.cloud/v3/integration/payment/manual/:id \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X DELETE -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true
}
POST/v3/integration/payment/manual/charge

Record Payment

Records a payment manually

Body parameters

Consumes

The following content type is required: application/json

Produces

The response content type: application/json

200 Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if success = false
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message
  • Name
    data
    Type
    object Required
    Description
    Payment schema

Properties for data object

  • Name
    amountCents
    Type
    integer Required
    Description
    amount charged or refunded
  • Name
    bulkPaymentId
    Type
    string Required
    Description
  • Name
    cardConfirmation
    Type
    string Required
    Description
  • Name
    cardDigits
    Type
    string Required
    Description
  • Name
    cardName
    Type
    string Required
    Description
  • Name
    cardType
    Type
    string Required
    Description
  • Name
    chargeFromPublicPage
    Type
    boolean Required
    Description
  • Name
    chargeId
    Type
    string Required
    Description
    reference for original payment if transaction type is different from charge
  • Name
    checkNumber
    Type
    string Required
    Description
  • Name
    companyId
    Type
    string Required
    Description
  • Name
    createdDate
    Type
    string Required
    Description
  • Name
    debitCard
    Type
    boolean Required
    Description
  • Name
    deposit
    Type
    boolean Required
    Description
  • Name
    disputedPaymentId
    Type
    string Required
    Description
    if a payment is a deduction/correction of a disputed payment, here we store link to that original disputed payment
  • Name
    disputedReason
    Type
    string Required
    Description
  • Name
    disputedStatus
    Type
    one of: Warning, NeedsResponse, UnderReview, Refunded, Won, Lost, Unknown Required
    Description
  • Name
    disputedType
    Type
    one of: Deduction, Fee, ReversedDeduction, ReversedFee Required
    Description
  • Name
    duesAndAssessmentsFee
    Type
    number Required
    Description
    0 = no fees yet, null = there will be no fees
  • Name
    feePricingModel
    Type
    one of: Blended, InterchangePlus, InterchangePlusFlat Required
    Description
  • Name
    id
    Type
    string Required
    Description
  • Name
    idempotencyKey
    Type
    string Required
    Description
  • Name
    imported
    Type
    boolean Required
    Description
  • Name
    interchangeFee
    Type
    integer Required
    Description
    0 = no fees yet, null = there will be no fees
  • Name
    locationId
    Type
    string Required
    Description
  • Name
    note
    Type
    string Required
    Description
  • Name
    orderId
    Type
    string Required
    Description
  • Name
    payerId
    Type
    string Required
    Description
  • Name
    paymentMode
    Type
    one of: Manual, Online, InPerson Required
    Description
  • Name
    paymentType
    Type
    one of: Check, Cash, Card, Other, ACH, Financing, PayPal, Venmo, Zelle, Insurance, Warranty, Internal, Mechanical_Installment, Policy, Reconditioning, Vehicle_Service_Contract, Account_Receivable, BNPL, BNPL_Sunbit, BNPL_Affirm, Interac_e__Transfer, Customer_Credit, Progressive, Acima, Snap_Finance, Care_Car_One, Home_Design, Wholesale, Quantum_Financing, Synchrony_Financing, Koalafi_Financing, Pay2Tomorrow, Work_Order_Adjustment, XPEL_Deals Required
    Description
  • Name
    payoutId
    Type
    string Required
    Description
  • Name
    provider
    Type
    one of: Finix, FirstMile, Manual, Stripe, Sunbit Required
    Description
  • Name
    providerData
    Type
    object
    Description
  • Name
    providerFee
    Type
    integer Required
    Description
  • Name
    receiptNumber
    Type
    integer Required
    Description
  • Name
    recordedDate
    Type
    string Required
    Description
    the date that the payment was recorded
  • Name
    refunded
    Type
    boolean Required
    Description
  • Name
    refundedAmountCents
    Type
    integer Required
    Description
    amount refunded for charge transactions
  • Name
    refundReason
    Type
    one of: Duplicate, Fraudulent, RequestedByCustomer Required
    Description
  • Name
    settlementId
    Type
    string Required
    Description
  • Name
    statementId
    Type
    string Required
    Description
  • Name
    status
    Type
    one of: Canceled, Failed, Pending, Processing, Succeeded Required
    Description
  • Name
    statusDetails
    Type
    string Required
    Description
    details about a status change when applicable
  • Name
    surchargeFee
    Type
    integer Required
    Description
  • Name
    transactionalFeeAmountCents
    Type
    integer Required
    Description
    amount charged as SM transactional fee (service fee
  • Name
    transactionType
    Type
    one of: Charge, Refund, Transfer, Dispute Required
    Description
  • Name
    updatedDate
    Type
    string Required
    Description
  • Name
    userData
    Type
    object
    Description

4xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

5xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST
/v3/integration/payment/manual/charge
curl https://api.shopmonkey.cloud/v3/integration/payment/manual/charge \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "orderId": "orderId",
    "payerId": null,
    "statementId": null,
    "recordedDate": null,
    "note": "note",
    "status": "status",
    "paymentType": "paymentType",
    "paymentMode": "paymentMode",
    "transactionType": "transactionType",
    "amountCents": 1,
    "refundedAmountCents": null,
    "refunded": true,
    "refundReason": null,
    "chargeId": null,
    "deposit": true,
    "checkNumber": null,
    "cardType": null,
    "cardDigits": null,
    "cardName": null,
    "cardConfirmation": null,
    "debitCard": true,
    "chargeFromPublicPage": true,
    "provider": null,
    "receiptNumber": 1,
    "providerFee": null,
    "transactionalFeeAmountCents": null,
    "disputedPaymentId": null,
    "disputedStatus": null,
    "disputedReason": null,
    "disputedType": null,
    "bulkPaymentId": null
  }
}
POST/v3/integration/payment/manual/charge/bulk

Record Bulk Payment

Records a bulk payment manually

This API has been deprecated and should no longer be used

Body parameters

Consumes

The following content type is required: application/json

Produces

The response content type: application/json

200 Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if success = false
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message
  • Name
    data
    Type
    array Required
    Description

4xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

5xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST
/v3/integration/payment/manual/charge/bulk
curl https://api.shopmonkey.cloud/v3/integration/payment/manual/charge/bulk \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": [
    {
      "id": "id",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "orderId": "orderId",
      "payerId": null,
      "statementId": null,
      "recordedDate": null,
      "note": "note",
      "status": "status",
      "paymentType": "paymentType",
      "paymentMode": "paymentMode",
      "transactionType": "transactionType",
      "amountCents": 1,
      "refundedAmountCents": null,
      "refunded": true,
      "refundReason": null,
      "chargeId": null,
      "deposit": true,
      "checkNumber": null,
      "cardType": null,
      "cardDigits": null,
      "cardName": null,
      "cardConfirmation": null,
      "debitCard": true,
      "chargeFromPublicPage": true,
      "payoutId": null,
      "provider": null,
      "receiptNumber": 1,
      "providerFee": null,
      "transactionalFeeAmountCents": null,
      "disputedPaymentId": null,
      "disputedStatus": null,
      "disputedReason": null,
      "disputedType": null,
      "bulkPaymentId": null
    }
  ]
}
PUT/v3/integration/payment/manual/charge/bulk/:id

Update Bulk Payment

Update a bulk payment manually

URL parameters

  • Name
    id
    Type
    string Required
    Description
    the id for the object

Body parameters

Consumes

The following content type is required: application/json

  • Name
    bulkPaymentId
    Type
    string
    Description
  • Name
    cardConfirmation
    Type
    string
    Description
  • Name
    cardDigits
    Type
    string
    Description
  • Name
    cardName
    Type
    string
    Description
  • Name
    cardType
    Type
    string
    Description
  • Name
    chargeFromPublicPage
    Type
    boolean
    Description
  • Name
    chargeId
    Type
    string
    Description
    reference for original payment if transaction type is different from charge
  • Name
    checkNumber
    Type
    string
    Description
  • Name
    debitCard
    Type
    boolean
    Description
  • Name
    deposit
    Type
    boolean
    Description
  • Name
    disputedPaymentId
    Type
    string
    Description
    if a payment is a deduction/correction of a disputed payment, here we store link to that original disputed payment
  • Name
    disputedReason
    Type
    string
    Description
  • Name
    disputedStatus
    Type
    one of: Warning, NeedsResponse, UnderReview, Refunded, Won, Lost, Unknown
    Description
  • Name
    disputedType
    Type
    one of: Deduction, Fee, ReversedDeduction, ReversedFee
    Description
  • Name
    duesAndAssessmentsFee
    Type
    number
    Description
    0 = no fees yet, null = there will be no fees
  • Name
    idempotencyKey
    Type
    string
    Description
  • Name
    interchangeFee
    Type
    integer
    Description
    0 = no fees yet, null = there will be no fees
  • Name
    note
    Type
    string
    Description
  • Name
    payerId
    Type
    string
    Description
  • Name
    paymentMode
    Type
    one of: Manual, Online, InPerson
    Description
  • Name
    paymentType
    Type
    one of: Check, Cash, Card, Other, ACH, Financing, PayPal, Venmo, Zelle, Insurance, Warranty, Internal, Mechanical_Installment, Policy, Reconditioning, Vehicle_Service_Contract, Account_Receivable, BNPL, BNPL_Sunbit, BNPL_Affirm, Interac_e__Transfer, Customer_Credit, Progressive, Acima, Snap_Finance, Care_Car_One, Home_Design, Wholesale, Quantum_Financing, Synchrony_Financing, Koalafi_Financing, Pay2Tomorrow, Work_Order_Adjustment, XPEL_Deals
    Description
  • Name
    payoutId
    Type
    string
    Description
  • Name
    provider
    Type
    one of: Finix, FirstMile, Manual, Stripe, Sunbit
    Description
  • Name
    providerData
    Type
    object
    Description
  • Name
    providerFee
    Type
    integer
    Description
  • Name
    receiptNumber
    Type
    integer
    Description
  • Name
    recordedDate
    Type
    string
    Description
    the date that the payment was recorded
  • Name
    refundedAmountCents
    Type
    integer
    Description
    amount refunded for charge transactions
  • Name
    refundReason
    Type
    one of: Duplicate, Fraudulent, RequestedByCustomer
    Description
  • Name
    statementId
    Type
    string
    Description
  • Name
    status
    Type
    one of: Canceled, Failed, Pending, Processing, Succeeded
    Description
  • Name
    statusDetails
    Type
    string
    Description
    details about a status change when applicable
  • Name
    surchargeFee
    Type
    integer
    Description
  • Name
    transactionalFeeAmountCents
    Type
    integer
    Description
    amount charged as SM transactional fee (service fee
  • Name
    transactionType
    Type
    one of: Charge, Refund, Transfer, Dispute
    Description
  • Name
    userData
    Type
    object
    Description
  • Name
    orders
    Type
    array
    Description

Produces

The response content type: application/json

200 Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if success = false
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message
  • Name
    data
    Type
    array Required
    Description

4xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

5xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

PUT
/v3/integration/payment/manual/charge/bulk/:id
curl https://api.shopmonkey.cloud/v3/integration/payment/manual/charge/bulk/:id \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X PUT -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true,
  "data": [
    {
      "id": "id",
      "createdDate": "createdDate",
      "updatedDate": null,
      "companyId": "companyId",
      "locationId": "locationId",
      "orderId": "orderId",
      "payerId": null,
      "statementId": null,
      "recordedDate": null,
      "note": "note",
      "status": "status",
      "paymentType": "paymentType",
      "paymentMode": "paymentMode",
      "transactionType": "transactionType",
      "amountCents": 1,
      "refundedAmountCents": null,
      "refunded": true,
      "refundReason": null,
      "chargeId": null,
      "deposit": true,
      "checkNumber": null,
      "cardType": null,
      "cardDigits": null,
      "cardName": null,
      "cardConfirmation": null,
      "debitCard": true,
      "chargeFromPublicPage": true,
      "payoutId": null,
      "provider": null,
      "receiptNumber": 1,
      "providerFee": null,
      "transactionalFeeAmountCents": null,
      "disputedPaymentId": null,
      "disputedStatus": null,
      "disputedReason": null,
      "disputedType": null,
      "bulkPaymentId": null
    }
  ]
}
DELETE/v3/integration/payment/manual/charge/bulk/:id/async

Async Delete Bulk Payment

Delete a bulk payment manually

URL parameters

  • Name
    id
    Type
    string Required
    Description
    the id for the object

Produces

The response content type: application/json

200 Response

  • Name
    inbox
    Type
    string
    Description
    The inbox subject to listen to for a response
  • Name
    success
    Type
    boolean Required
    Description

4xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

5xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

DELETE
/v3/integration/payment/manual/charge/bulk/:id/async
curl https://api.shopmonkey.cloud/v3/integration/payment/manual/charge/bulk/:id/async \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -X DELETE -H 'Content-Type: application/json' \
  --data '{}'

Example Response
application/json

{
  "success": true
}
POST/v3/integration/payment/manual/refund

Create

Create an

Body parameters

Consumes

The following content type is required: application/json

  • Name
    chargeId
    Type
    string Required
    Description
    The payment id to refund
  • Name
    amountCents
    Type
    integer Required
    Description
    amount charged or refunded
  • Name
    paymentType
    Type
    one of: Check, Cash, Card, Other, ACH, Financing, PayPal, Venmo, Zelle, Insurance, Warranty, Internal, Mechanical_Installment, Policy, Reconditioning, Vehicle_Service_Contract, Account_Receivable, BNPL, BNPL_Sunbit, BNPL_Affirm, Interac_e__Transfer, Customer_Credit, Progressive, Acima, Snap_Finance, Care_Car_One, Home_Design, Wholesale, Quantum_Financing, Synchrony_Financing, Koalafi_Financing, Pay2Tomorrow, Work_Order_Adjustment, XPEL_Deals Required
    Description
  • Name
    recordedDate
    Type
    string Required
    Description
    the date that the payment was recorded
  • Name
    refundReason
    Type
    one of: Duplicate, Fraudulent, RequestedByCustomer Required
    Description
  • Name
    note
    Type
    string
    Description

Produces

The response content type: application/json

200 Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if success = false
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message
  • Name
    data
    Type
    object Required
    Description
    Payment schema

Properties for data object

  • Name
    amountCents
    Type
    integer Required
    Description
    amount charged or refunded
  • Name
    bulkPaymentId
    Type
    string Required
    Description
  • Name
    cardConfirmation
    Type
    string Required
    Description
  • Name
    cardDigits
    Type
    string Required
    Description
  • Name
    cardName
    Type
    string Required
    Description
  • Name
    cardType
    Type
    string Required
    Description
  • Name
    chargeFromPublicPage
    Type
    boolean Required
    Description
  • Name
    chargeId
    Type
    string Required
    Description
    reference for original payment if transaction type is different from charge
  • Name
    checkNumber
    Type
    string Required
    Description
  • Name
    companyId
    Type
    string Required
    Description
  • Name
    createdDate
    Type
    string Required
    Description
  • Name
    debitCard
    Type
    boolean Required
    Description
  • Name
    deposit
    Type
    boolean Required
    Description
  • Name
    disputedPaymentId
    Type
    string Required
    Description
    if a payment is a deduction/correction of a disputed payment, here we store link to that original disputed payment
  • Name
    disputedReason
    Type
    string Required
    Description
  • Name
    disputedStatus
    Type
    one of: Warning, NeedsResponse, UnderReview, Refunded, Won, Lost, Unknown Required
    Description
  • Name
    disputedType
    Type
    one of: Deduction, Fee, ReversedDeduction, ReversedFee Required
    Description
  • Name
    duesAndAssessmentsFee
    Type
    number Required
    Description
    0 = no fees yet, null = there will be no fees
  • Name
    feePricingModel
    Type
    one of: Blended, InterchangePlus, InterchangePlusFlat Required
    Description
  • Name
    id
    Type
    string Required
    Description
  • Name
    idempotencyKey
    Type
    string Required
    Description
  • Name
    imported
    Type
    boolean Required
    Description
  • Name
    interchangeFee
    Type
    integer Required
    Description
    0 = no fees yet, null = there will be no fees
  • Name
    locationId
    Type
    string Required
    Description
  • Name
    note
    Type
    string Required
    Description
  • Name
    orderId
    Type
    string Required
    Description
  • Name
    payerId
    Type
    string Required
    Description
  • Name
    paymentMode
    Type
    one of: Manual, Online, InPerson Required
    Description
  • Name
    paymentType
    Type
    one of: Check, Cash, Card, Other, ACH, Financing, PayPal, Venmo, Zelle, Insurance, Warranty, Internal, Mechanical_Installment, Policy, Reconditioning, Vehicle_Service_Contract, Account_Receivable, BNPL, BNPL_Sunbit, BNPL_Affirm, Interac_e__Transfer, Customer_Credit, Progressive, Acima, Snap_Finance, Care_Car_One, Home_Design, Wholesale, Quantum_Financing, Synchrony_Financing, Koalafi_Financing, Pay2Tomorrow, Work_Order_Adjustment, XPEL_Deals Required
    Description
  • Name
    payoutId
    Type
    string Required
    Description
  • Name
    provider
    Type
    one of: Finix, FirstMile, Manual, Stripe, Sunbit Required
    Description
  • Name
    providerData
    Type
    object
    Description
  • Name
    providerFee
    Type
    integer Required
    Description
  • Name
    receiptNumber
    Type
    integer Required
    Description
  • Name
    recordedDate
    Type
    string Required
    Description
    the date that the payment was recorded
  • Name
    refunded
    Type
    boolean Required
    Description
  • Name
    refundedAmountCents
    Type
    integer Required
    Description
    amount refunded for charge transactions
  • Name
    refundReason
    Type
    one of: Duplicate, Fraudulent, RequestedByCustomer Required
    Description
  • Name
    settlementId
    Type
    string Required
    Description
  • Name
    statementId
    Type
    string Required
    Description
  • Name
    status
    Type
    one of: Canceled, Failed, Pending, Processing, Succeeded Required
    Description
  • Name
    statusDetails
    Type
    string Required
    Description
    details about a status change when applicable
  • Name
    surchargeFee
    Type
    integer Required
    Description
  • Name
    transactionalFeeAmountCents
    Type
    integer Required
    Description
    amount charged as SM transactional fee (service fee
  • Name
    transactionType
    Type
    one of: Charge, Refund, Transfer, Dispute Required
    Description
  • Name
    updatedDate
    Type
    string Required
    Description
  • Name
    userData
    Type
    object
    Description

4xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

5xx Response

  • Name
    code
    Type
    string
    Description
    The error code
  • Name
    data
    Type
    object
    Description
    An optional object containing relevant error data
  • Name
    documentation_url
    Type
    string
    Description
    An optional link to the documentation for the error
  • Name
    message
    Type
    string
    Description
    the error message if not successful
  • Name
    success
    Type
    boolean Required
    Description
    if successful, will be true. if not successful, will be false and message will contain a human readable error message

Example Request
application/json

POST
/v3/integration/payment/manual/refund
curl https://api.shopmonkey.cloud/v3/integration/payment/manual/refund \
  -H "Authorization: Bearer ${SM_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data '{ "chargeId" : "value", "amountCents" : 0, "paymentType" : "value", "recordedDate" : "value", "refundReason" : "value" }'

Example Response
application/json

{
  "success": true,
  "data": {
    "id": "id",
    "createdDate": "createdDate",
    "updatedDate": null,
    "companyId": "companyId",
    "locationId": "locationId",
    "orderId": "orderId",
    "payerId": null,
    "statementId": null,
    "recordedDate": null,
    "note": "note",
    "status": "status",
    "paymentType": "paymentType",
    "paymentMode": "paymentMode",
    "transactionType": "transactionType",
    "amountCents": 1,
    "refundedAmountCents": null,
    "refunded": true,
    "refundReason": null,
    "chargeId": null,
    "deposit": true,
    "checkNumber": null,
    "cardType": null,
    "cardDigits": null,
    "cardName": null,
    "cardConfirmation": null,
    "debitCard": true,
    "chargeFromPublicPage": true,
    "provider": null,
    "receiptNumber": 1,
    "providerFee": null,
    "transactionalFeeAmountCents": null,
    "disputedPaymentId": null,
    "disputedStatus": null,
    "disputedReason": null,
    "disputedType": null,
    "bulkPaymentId": null
  }
}