STstreampay
Payments

Get Payment

Changed on

Retrieve detailed information about a specific payment by its ID.

get/api/v2/payments/{payment_id}

Request

  • Base URL
    https://stream-app-service.streampay.sa
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Path parameters

payment_idstring uuid required

Unique identifier (UUID) of the payment

Response

Successful Response

idstring uuid

Unique identifier (UUID) of the payment

amountstring

Payment amount

currency'SAR' | 'USD' | 'EUR' | 'GBP' | 'AED' | 'BHD' | 'KWD' | 'OMR' | 'QAR'

ISO 4217 currency codes supported by Moyasar.

Includes all currencies supported by Moyasar payment gateway.

scheduled_onstring

Scheduled date and time for the payment

type'INITIAL' | 'INSTALLMENT' | 'SPLIT_PREPAID' | 'SPLIT_REMAINDER'
payment_method'MADA' | 'MASTERCARD' | 'VISA' | 'APPLE_PAY' | 'SAMSUNG_PAY' | 'AMEX' | 'CASH' | 'PGW_CARD_UNSPECIFIED' | 'BANK_TRANSFER' | 'CARD' | 'QURRAH' | 'BNPL'
current_status'PENDING' | 'PROCESSING' | 'FAILED_INITIATION' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' | 'UNDER_REVIEW' | 'EXPIRED' | 'SETTLED' | 'REFUNDED' | 'PARTIALLY_REFUNDED'
payed_atstring date-time nullable

Date and time when the payment was completed

refunded_atstring date-time nullable

Date and time of the most recent refund

refund_reason'REQUESTED_BY_CUSTOMER' | 'DUPLICATE' | 'FRAUDULENT' | 'OTHER'
refund_notestring nullable

Note for the most recent refund if set

amount_refundedstring

Sum of all refund rows for this payment

latest_pgw_messagestring nullable

Latest payment gateway message for this payment

pos_transaction_idstring nullable

Transaction/network reference ID for card/POS payments

amount_in_smallest_unitinteger

Payment amount in smallest currency unit (e.g. halala for SAR).

Changes

  • 85261606a8eaRevision changes
    • info

      added the optional property to the response with the status

  • 515eeea7d260Revision changes
    • warning

      added the new BNPL enum value to the response property for the response status

    • warning

      added the new PARTIALLY_REFUNDED enum value to the response property for the response status

    • warning

      added the new SPLIT_REMAINDER enum value to the response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status