Payment Batches

Retrieve a payment batch

Retrieve a specific payment batch from your account.

get/payment-batches/{paymentBatchId}

Request

Path parameters

paymentBatchIdstring uuid required

The unique ID of the Payment Batch.

Query parameters

accountIdstring required

The ID of the account to work with.

Example:F50091
'alertErrors' | 'alertWarnings' | 'ordersSummary'
OR
string[]

Response

OK

idstring uuid required

The unique ID of the Payment Batch.

accountIdstring required

The ID of the account the Payment Batch belongs.

namestring nullable required

The name of the Payment Batch.

status'draft' | 'validated' | 'confirmed' | 'started' | 'completed' | 'failed' | 'cancelled' required

The status of the Payment Batch.

visibleboolean nullable required

Whether the payment batch is visible to other API users

visibleAtstring date-time nullable required

Timestamp indicating when the payment batch was made visible. UTC.

confirmedAtstring date-time nullable required

Timestamp indicating when the payment batch was confirmed. UTC.

passedMfaCheckAtstring date-time nullable required

Timestamp indicating when the payment batch passed MFA check. UTC.

riskCheckedAtstring date-time nullable required

Timestamp indicating when the payment batch was risk checked. UTC.

ordersSentAtstring date-time nullable required

Timestamp indicating when the orders were sent. UTC.

createdAtstring date-time required

Timestamp indicating when the payment batch was created. UTC.

updatedAtstring date-time required

Timestamp indicating when the payment batch was updated. UTC.

Example response

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "accountId": "string",
  "name": "string",
  "createdBy": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "type": "person"
  },
  "product": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string"
  },
  "status": "draft",
  "visible": true,
  "visibleAt": "2019-08-24T14:15:22Z",
  "confirmedBy": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "type": "person"
  },
  "confirmedAt": "2019-08-24T14:15:22Z",
  "passedMfaCheckAt": "2019-08-24T14:15:22Z",
  "riskCheckedAt": "2019-08-24T14:15:22Z",
  "ordersSentAt": "2019-08-24T14:15:22Z",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "alerts": [
    {
      "timestamp": "2019-08-24T14:15:22Z",
      "type": "Error",
      "code": "string",
      "message": "string"
    }
  ],
  "ordersSummary": {
    "numberOfOrders": 0,
    "uniqueCurrencyCodes": [
      "USD"
    ]
  },
  "input": {
    "format": "json",
    "status": "accepted",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}

Changes

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