Skip to main content

10. Create order​

You can create the order information in advance on the Wonder side through the Create Order API, and then pass the order number to Payment SDK / Payment ECR to complete the payment.

reference_number: We strongly recommend that you pass the reference number parameter to be associated with your ordering system.

Query Parameters
    with_payment_link boolean

    If you need create wonder payment link

    Example: true
Header Parameters
    Nonce string required

    random 16 bytes alphanumerics

    Credential string required

    Please follow the OpenAPI authentication section

    Example: d900da8b-6e16-4a85-8a66-05d29ac53f24/20240501120123/Wonder-RSA-SHA256
    Signature string required

    Please follow the OpenAPI authentication section

    Example: good
    Content-type string required
    Example: application/json
    x-request-id string
    Example: {% mock 'uuid' %}
Request Body
    order object required
    charge_fee charge fee required

    Default value: 0.00

    The amount you charge your customers

    tips charge fee

    Default value: 0.00

    The amount you charge your customers

    currency currency code required

    currency code, eg HKD

    reference_number your side unique number required

    your side unique number

    due_date due date

    If this date is exceeded, the order will be automatically voided

    note note

    Note information for the order, needs to be less than 255 characters

    line_items object[]

    If you wish to display additional line item information

  • Array [
    • uuid uuid

    UUID V4

    purchasable_type PurchasableType required

    Possible values: [RearTips, Charge]

    purchase_id string

    just for purchaseable_type = Listing

    price string required
    quantity string required
    total string required
    label Product Name

    Product Name

  • ]
    • callback_url callback url

    The address of the backend webhook

    redirect_url redirect_url

    The redirection address after the payment link is completed

Responses

success

Schema
    error_code string required
    error_message string required
    data object
    order object required
    source Transaction source required

    Transaction source

    type Order type required

    Order type

    number Wonder unique id required

    Wonder unique id

    reference_number Your Side unique id required

    your side unique id

    initial_total Order total required

    Order total

    initial_tips Order tips required

    Order tips

    subtotal integer required
    paid_total Order Paid total required

    sum of successful transaction amount

    unpaid_total Order unpaid total required

    initial_total - paid_total

    state Order state required

    Order state

    correspondence_state Order payment state required

    Order payment state

    currency Currency required
    return_url frontend return url

    for payment link, when payment finished redirect to this url

    notify_url Webhook url

    if you fill it, wonder will callback your this url after state changed

    line_items object[]
  • Array [
    • uuid string
    purchasable_type PurchasableType required

    Possible values: [RearTips, Charge]

    purchase_id integer
    price integer required
    quantity integer required
    total integer required
    label string
  • ]
    • transactions object[]
  • Array [
    • type Transaction Type required

    Possible values: [Sales, Authorization, Refund, Capture]

    uuid Wonder transaction uuid required

    Wonder transaction uuid

    currency transaction currency required

    transaction currency

    amount transaction amount required

    transaction amount

    success success required

    if transaction successful

    is_pending boolean required

    for async payment,if transaction still pending

    captured boolean required

    for card pure-auth,if transaction captured

    allow_void boolean required

    if transaction allowed to void

    allow_refund boolean required

    if transaction allowed to refund

    void_is_pending boolean required

    if void still pending

    payment_method string required

    which payment method

    note string required

    transaction remark

    payment_data object required

    related to payment method

    acquirer_name string required
    acquirer_type string required
    auth_code string required
    brn string required
    card_id string required
    card_number_len integer required
    card_read_mode string required
    credit_card_type string required
    first_6_digits string required
    last_4_digits string required
    merchant_id string required
    new_gateway_txn_id string required
    payment_method string required
    receipt_id string required
    rrn string required
    transaction_state string required
    original_transaction_uuid original transacation uuid

    original transacation uuid

  • ]
    • payment_link Payment Link Url

    if you pass with_payment_link=true query params

Loading...