STC Pay Payment

1min
Use this endpoint to create payment requests using an 'stcpay' source
POST
Request
Body Parameters
amount
required
Integer
Amount intended to be collected by this payment. A positive integer represents how much to charge in the smallest currency unit (e.g., 100 Halala to charge 1.00 SAR or 100 to charge ¥100, a zero-decimal currency). The minimum amount is 1 SAR or equivalent in charge currency. 
currnecy
optional
String
stc pay only accepts SAR
description
optional
String
An arbitrary string that you can attach to a payment object. The description is only for your reference and it is NOT displayed to users.
source
required
Object
A payment source object to be charged, such as Apple Pay source, Credit Card source, or STC pay source. The details are described below. ('creditcard' for this example)
metadata
optional
Object
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.
Curl
curl -X POST https://api.moyasar.com/v1/payments \
--header 'Accept: application/json' \
--data-raw '{"amount":"string","currnecy":"string","description":"string","callback_url":"string","source":"Object","metadata":"Object"}'
curl -X POST https://api.moyasar.com/v1/payments \
--header 'Accept: application/json' \
--data-raw '{"amount":"string","currnecy":"string","description":"string","callback_url":"string","source":"Object","metadata":"Object"}'
Responses
201
400
{
  "id": "760878ec-d1d3-5f72-9056-191683f55872",
  "status": "initiated",
  "amount": 60000,
  "fee": 1580,
  "currency": "SAR",
  "refunded": 0,
  "refunded_at": null,
  "captured": 0,
  "captured_at": null,
  "voided_at": null,
  "description": null,
  "amount_format": "600 SAR",
  "fee_format": "15.80 SAR",
  "refunded_format": "0.00 SAR",
  "captured_format": "0.00 SAR",
  "invoice_id": "9785ba96-a1be-5b13-a281-b27a4a6dad39",
  "ip": null,
  "callback_url": null,
  "created_at": "2016-05-11T17:04:17.000Z",
  "updated_at": "2016-05-12T17:04:19.633Z",
  "metadata": null,
  "source": {
    "type": "stcpay",
    "mobile": "055xxxxxxx",
        "reference_number": "65212923376111",
        "branch": null,
        "cashier": null,
        "transaction_url": "",
        "message": null
  }
}
{
  "id": "760878ec-d1d3-5f72-9056-191683f55872",
  "status": "initiated",
  "amount": 60000,
  "fee": 1580,
  "currency": "SAR",
  "refunded": 0,
  "refunded_at": null,
  "captured": 0,
  "captured_at": null,
  "voided_at": null,
  "description": null,
  "amount_format": "600 SAR",
  "fee_format": "15.80 SAR",
  "refunded_format": "0.00 SAR",
  "captured_format": "0.00 SAR",
  "invoice_id": "9785ba96-a1be-5b13-a281-b27a4a6dad39",
  "ip": null,
  "callback_url": null,
  "created_at": "2016-05-11T17:04:17.000Z",
  "updated_at": "2016-05-12T17:04:19.633Z",
  "metadata": null,
  "source": {
    "type": "stcpay",
    "mobile": "055xxxxxxx",
        "reference_number": "65212923376111",
        "branch": null,
        "cashier": null,
        "transaction_url": "",
        "message": null
  }
}
﻿
﻿
Updated 09 Sep 2024
Did this page help you?
Apple Pay Payment
Token Payment