Skip to main content

List Direct Debit Payments

GET 
/direct-debit-payments

Request​

Query Parameters

    after string

    An object ID that is used as a cursor in pagination. For instance, if you make a list request and receive 100 objects, ending with obj_foo42, your subsequent call can include after=obj_foo42 in order to fetch the next page of the list.

    limit integer

    Possible values: >= 1 and <= 100

    Default value: 10

    A limit on the number of objects to be returned, between 1 and 100.

    order string

    Possible values: [ASC, DESC]

    Default value: DESC

    Sort list objects in either ascending or descending order.

    status string

    Possible values: [PROCESSING, SUCCEEDED, FAILED]

Responses​

OK

Response Headers

  • Acme-Mode

    string

    Has the value LIVE if the data exists in live production mode or the value TEST if the data exists in test sandbox mode.

Schema

    data

    object[]

    required

  • Array [

    • id stringrequired

    Unique identifier for the object.

    type stringrequired

    Possible values: [FAST]

    Type of the payment

    amount integerrequired

    A positive integer value in specified currency's smallest unit. e.g. $10 would be represented as 1000 (cents).

    currency stringrequired

    Possible values: [SGD]

    Three-letter ISO 4217 currency code in full uppercase.

    customerReference stringrequired

    Possible values: Value must match regular expression ^[a-zA-Z0-9\-]{1,35}$

    A meaningful description of the debit/payment. This will show up in your payer's bank statement.

    directDebitAuthorizationId stringrequired

    A Direct Debit Authorization ID, eg. dda_1234567. This is required for pulling money from an external bank account via direct debit. Only required for direct debits.

    status stringrequired

    Possible values: [PROCESSING, SUBMITTED, SUCCEEDED, FAILED]

    Status of the payment

    previousPaymentStatus string

    Possible values: [PROCESSING, SUBMITTED, SUCCEEDED, FAILED]

    For FAILED payments with resultCode DUPLICATE_TRANSACTION, the status of the previous payment, if we know it.

    resultCode string

    Possible values: [INVALID_AMOUNT, TRANSACTION_LIMIT_EXCEEDED, DIRECT_DEBIT_AUTHORIZATION_TERMINATED, DIRECT_DEBIT_AUTHORIZATION_EXPIRED, PAYER_ACCOUNT_CLOSED, INSUFFICIENT_FUNDS, DUPLICATE_TRANSACTION, OTHERS]

    Additional information when status is FAILED, if available.

    • INVALID_AMOUNT: Requested debit amount is not valid. E.g. the amount is larger than the maximum amount allowed by the FAST network.
    • TRANSACTION_LIMIT_EXCEEDED: Requested debit amount exceeds the maximum amount set in the Direct Debit Authorization.
    • DIRECT_DEBIT_AUTHORIZATION_TERMINATED: Payer has terminated the Direct Debit Authorization.
    • DIRECT_DEBIT_AUTHORIZATION_EXPIRED: Direct Debit Authorization has expired.
    • PAYER_ACCOUNT_CLOSED: Payer's bank account has been closed.
    • INSUFFICIENT_FUNDS: Payer's bank account does not have sufficient balance.
    • DUPLICATE_TRANSACTION: This payment not processed because it is a duplicate of a previous payment, ensure you use a unique customerReference.
    • OTHERS: Generic or unknown reason. If you need to find out more, reach out to Acme Support.
    createdAt stringrequired

    Time at which the object was created. In ISO 8601 format.

    updatedAt stringrequired

    Time at which the object was last updated. In ISO 8601 format.

  • ]

    • hasMore booleanrequired
Loading...