Skip to main content

List Hosted Payments

GET 
/hosted-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

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
    status stringrequired

    Possible values: [REQUIRES_ACTION, PENDING, SUCCEEDED, FAILED]

    Status of the payment

    resultCode string

    Possible values: [PAYLAH_WALLET_DELINKED, PAYLAH_WALLET_ALREADY_LINKED, INSUFFICIENT_FUNDS_PENDING_TOP_UP, OTHERS]

    Result code of the payment, if available. Possible values are:

    • PAYLAH_WALLET_DELINKED: The payer has delinked their PayLah! Wallet and the specified hostedPaymentMethodId can no longer be used for creating payments.
    • PAYLAH_WALLET_ALREADY_LINKED: The specified PayLah! Wallet number has already been linked before. You should set the hostedPaymentMethodId in the request body.
    • INSUFFICIENT_FUNDS_PENDING_TOP_UP: The payer has insufficient funds in their PayLah! Wallet and the payer needs to top up their wallet in 5 minutes. You should keep polling the hosted payment status.
    • OTHERS
    amount integerrequired
    currency stringrequired

    Possible values: [SGD]

    Three-letter ISO 4217 currency code in full uppercase.

    method string

    Possible values: [PAYLAH, PAYNOW]

    channel stringrequired

    Possible values: [APP_IOS, APP_ANDROID, WEB_BROWSER_DESKTOP, WEB_BROWSER_MOBILE]

    returnUrl stringrequired

    For web browser based channel, use a HTTPS URL. For native mobile based channel, use an App Deep Link URL.

    redirectUrl string

    Redirect the payer to this URL for payment.

    referenceId string

    A string to reference (e.g. your order ID, a payment ID, etc.) which can be used to reconcile the hosted payment with your own systems. This cannot exceed 255 characters.

    tokenization boolean

    Only applicable to method=PAYLAH. If set to true, this is a tokenized payment, and you can find the token representing the customer's payment method information in the hostedPaymentMethodId field after the payment is completed.

    hostedPaymentMethodId string

    Token representing your customer's payment method information.

    If this is a tokenized payment (tokenization=true), this field is set after the customer has completed the payment. Listen to the hosted-payments.succeeded webhook or use GET /v1/hosted-payments/{id} to retrieve this token. You should save and associate this token with the customer, so that you may collect future payments from the same customer without requiring them to key in their payment method information again.

    createdAt stringrequired
    updatedAt stringrequired

  • ]

    • hasMore booleanrequired
Loading...