Source API

Create and retrieve payment sources. Sources are methods for accepting payments through non-credit-card channels (including Alipay, convenience store, internet banking and installment payments).

Attributes

Name Type Description
object string

The string source

id string

The source identifier matching /src(_test)?_[0-9a-z]+/

livemode boolean

Whether this is a live (true) or test (false) source

location string

API path to retrieve the current source object

absorption_type string

Which entity absorbs interest for installment payments. One of customer or merchant (type=installment_*)

amount integer

Source amount in smallest unit of source currency

bank string

Bank (type=fpx)

barcode string

Barcode number (type=barcode_alipay)

billing object

Billing address. See source creation parameters for more details.

charge_status string

Status of charge created using this source (if any). Value is one of allowed charge.status values or, no charge has been created, unknown

created string

UTC datetime of source creation in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ)

currency string

Currency for source as three-letter ISO 4217 code

discounts array

Discounts (type=qr_code_upi)

email string

Payer email address (type=econtext,fpx)

flow string

The payment flow payers need to go through to complete the payment. One of redirect, offline, or app_redirect:

  • redirect: payer must be redirected to external website (charge.authorize_uri) to complete payment.
  • offline: payer will receive payment information to complete payment offline (charge.source.references).
  • app_redirect: payer must be redirected to an app (charge.authorize_uri) to complete payment.
installment_terms integer

Installment term in months. See installments for allowed values (type=installment_*)

ip string

IP address provided to Opn Payments at source creation. May be IPv4 or IPv6.

items array

Information about items included in the order. See source creation parameters for more details.

mobile_number string

Payer phone number (type=econtext,truemoney)

name string

Payer name (type=econtext)

phone_number string

Payer phone number (type=econtext,truemoney)

platform_type string

Platform from which payer is making a payment. One of WEB, IOS, or ANDROID.

promotion_code string

The code that grants access to special offers or discounts provided by the service provider.

provider_references object

Denotes the transaction references for payments made. The following payment methods return transaction references:

  • promptpay
  • paynow
  • mobile_banking_scb
  • mobile_banking_ktb
  • mobile_banking_kbank
  • mobile_banking_bay
  • mobile_banking_bbl

This object returns null for all other payment providers.

receipt_amount integer

Receipt amount (type=qr_code_upi)

references object

Reference information about the payment (type=bill_payment_tesco_lotus,econtext,barcode_alipay)

scannable_code barcode

Barcode object

shipping object

Shipping address. See source creation parameters for more details.

store_id string

Store ID for payment source (type=barcode_alipay)

store_name string

Store name for payment source (type=barcode_alipay)

terminal_id string

Terminal ID for payment source (type=barcode_alipay)

type string

Payment source type

Example

  • JSON Response

Omise uses cookies to improve your overall site experience and collect information on your visits and browsing behavior. By continuing to browse our website, you agree to our Privacy Policy. Learn more