6DOT50 APIs
  • Redemptions API
    • Overview
    • Process Flow
    • Requests
    • Response Models
    • Payment Codes
    • Authentication
      • POST /authentication/getToken
  • Accounts
    • GET /accounts
    • GET /accounts/{id}/transactions
  • Initiate Payment
    • POST /payments
  • User Payment Pages
    • Authentication
    • Payment Confirmation
    • Payment Status
  • Payment Status
    • GET /payments/{id}
  • List Payments
    • GET /payments
  • Support
  • PAY API
    • Overview
    • API Keys
    • Endpoints
    • Process Flow
    • Requests
    • Response Models
    • Authentication
      • POST /authentication/getToken
    • Accounts
      • GET /accounts
    • Batches
      • POST /batches
      • GET /batches
      • GET /batches/{id}
      • PUT /batches/{id}
      • GET /batches/statusCodes
      • POST /batches/{id}/payments
      • GET /batches/{id}/payments
      • POST /batches/{id}/submit
      • POST /batches/{id}/cancel
    • Members
      • GET /members/{msisdn}/exists
    • Payments
      • GET /payments/{id}
      • DELETE /payments/{id}
      • GET /payments/statusCodes
  • Support
Powered by GitBook
On this page
  1. PAY API

Batches

PreviousGET /accountsNextPOST /batches

Last updated 2 years ago

Batches contain one or more Payments to be made to users from an Organisation's PAY .

Batch Status Codes

Every Batch has a Status. Based on a Batch's status, certain operations can be performed against the Batch:

Batch Status Code
Description
Allowed Operations

DRAFT

When a new Batch is created, it is created in a DRAFT status.

Update Batch details using Add Payments using Remove Payments using

OPEN

When a Batch is submitted for processing, it changes to an OPEN state. A Batch will remain OPEN as long as there are payments pending to non-6DOT50 members.

Read current Batch status using

CLOSED

A Batch will have a CLOSED status when all payments in the Batch have been processed. A Batch becomes immutable once it is closed.

Read Batch details (history) using .

CANCELLED

A Batch will only have a CANCELLED status if it was cancelled using the operation. A Batch becomes immutable once it is cancelled and cannot be re-opened.

Read Batch details (history) using .

Creating a Batch does not immediately initiate any payments to users. Payments will only be made if the Batch is submitted for processing using .

Account
POST /batches/{id}/submit
PUT batches/{id}
POST batches/{id}/payments
DELETE payments/{id}
GET /batches/{id}
GET /batches/{id}
POST /batches/{id}/cancel
GET /batches/{id}