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
  • Request
  • Response
  1. PAY API
  2. Batches

GET /batches/{id}/payments

This operation returns a list of Payments for a specific Batch.

Request

Ensure the bearer token is included in the Header of the GET operation:

Header
Mandatory
Description

Authorization

Yes

Parameter
Mandatory
Description

id

Yes

The Batch ID to query

Response

If successful, the operation will return with a standard Payment model:

[
  {
    "id": "string($guid)",
    "batchId": "string($guid)",
    "msisdn": "string",
    "amount": decimal,
    "firstname": "string",
    "lastname": "string",
    "externalId": "string",
    "statusCode": "string",
    "settledAt": "string($date-time)",
    "isMember": boolean,
    "referralAmount": decimal,
    "referralMsisdn": "string",
    "createdAt": "string($date-time)"
  }
]
Field
Response Type
Description

id

string($guid)

Unique ID for the Payment. Can be used to perform payment specific operations using /payments

batchId

string($guid)

The Batch ID that the Payment is part of.

msisdn

string

The mobile number that will be/has been paid, formatted in international dialing format. e.g. 27821231234.

amount

decimal

The amount that will be/has been paid for the Payment.

firstname

string

Firstname of the user.

lastname

string

Lastname of the user.

externalId

string

Payment identifier supplied by external system for tracing purposes.

statusCode

string

settledAt

string($date-time)

The date at which the Payment was paid into the user's account.

isMember

boolean

true = the user is a member of 6DOT50, false = the user is not a member of 6DOT50.

referralAmount

decimal

The Amount to allocate as a referral. Only applicable if Referral capability has been enabled for the Organisation.

referralMsisdn

string

The MSISDN of the referral. Only applicable if Referral capability has been enabled for the Organisation.

createdAt

string($date-time)

The date and time when the Payment was created.

PreviousPOST /batches/{id}/paymentsNextPOST /batches/{id}/submit

Last updated 2 years ago

Bearer token from

Status code for the Payment. See for a valid list.

/authentication/getToken
Payment Status Codes