Ուղեցույց

Հոսք

• 1. Կանչել pspg_create_paylink()
• 2. PSPG-ն ստեղծում է նոր տող wp_pspg_orders աղյուսակում
• 3. PSPG-ն գեներացնում է public PayLink հղում
• 4. PSPG-ն պահպանում է paylink.create իրադարձությունը լոգերում
• 5. Օգտատերը բացում է հղումը և սկսում վճարումը
• 6. PSPG-ն թարմացնում է կարգավիճակը վճարման հոսքի ընթացքում

Սցենարներ

• Մեկանգամյա հղում — օգտագործվում է մեկ վճարման համար
• Անսահմանափակ հղում — կարող է օգտագործվել բազմիցս

Սցենար 1: Մեկանգամյա հղում

$result = pspg_create_paylink(
	array(
		'bank'          => 'arca_idbank',
		'currency_code' => 'AMD',
		'amount'        => '10.00',
		'link_mode'     => 'single',
		'purpose'       => 'Order payment',
		'description'   => 'Single PayLink',
	)
);

Սպասվող արդյունք՝

{
	"ok": true,
	"pspg_order_id": 123,
	"paylink_url": "https://example.com/pspg/paylink/123/abcdef1234567890",
	"bank": "arca_idbank",
	"currency_code": "051",
	"amount": "10.00",
	"link_mode": "single",
	"purpose": "Test payment",
	"description": "Test PayLink",
	"test_mode": 1
}

Սցենար 2: Անսահմանափակ հղում

$result = pspg_create_paylink(
	array(
		'bank'          => 'arca_idbank',
		'currency_code' => 'AMD',
		'amount'        => '10.00',
		'link_mode'     => 'unlimited',
		'purpose'       => 'Donation',
		'description'   => 'Unlimited PayLink',
	)
);

Սպասվող արդյունք՝

{
	"ok": true,
	"pspg_order_id": 123,
	"paylink_url": "https://example.com/pspg/paylink/123/abcdef1234567890",
	"bank": "arca_idbank",
	"currency_code": "051",
	"amount": "10.00",
	"link_mode": "unlimited",
	"purpose": "Donation",
	"description": "Unlimited PayLink",
	"test_mode": 1
}

Պատասխանի կառուցվածք

• ok — հղումը հաջողությամբ ստեղծվել է
• pspg_order_id — PSPG պատվերի ներքին ID
• paylink_url — public վճարման հղում
• bank — ընտրված բանկի ID
• currency_code — ISO թվային արժույթի կոդ
• amount — նորմալացված գումար
• link_mode — single կամ unlimited
• purpose — ներքին նպատակի նշում
• description — նկարագրություն
• test_mode — բանկի test/live ռեժիմ

Կարգավիճակներ

• created — հղումը ստեղծված է, բայց վճարումը դեռ չի սկսվել
• registered — բանկում պատվերը ստեղծված է
• paid — վճարումը հաջողությամբ ավարտված է

Հասանելի bank ID-ներ

• ameria — Ameriabank
• ineco — Inecobank
• amio — AMIO Bank
• arca_acba — ACBA Bank (ArCa)
• arca_ararat — Araratbank (ArCa)
• arca_armeconombank — Armeconombank (ArCa)
• arca_armswiss — Armswissbank (ArCa)
• arca_ardshin — Ardshinbank (ArCa)
• arca_byblos — Byblos Bank Armenia (ArCa)
• arca_converse — Converse Bank (ArCa)
• arca_evoca — Evocabank (ArCa)
• arca_fastbank — Fast Bank (ArCa)
• arca_idbank — IDBank (ArCa)

Կարևոր

• bank, currency_code, amount, description պարտադիր են
• currency_code-ը ընդունում է և՛ տեքստային, և՛ թվային արժեքներ (օրինակ՝ AMD կամ 051)
• link_mode-ը կարող է լինել միայն single կամ unlimited
• test_mode-ը որոշվում է ավտոմատ՝ բանկի կարգավորումներից
• PayLink տվյալները միշտ պահպանվում են paylink.create իրադարձությամբ
• Դեբագի համար օգտագործեք pspg_order_id և ստուգեք wp_pspg_orders աղյուսակը

Օգտագործելով այս API-ն և օրինակները՝ դուք համաձայնվում եք մեր Terms & Conditions-ին։
Խորհուրդ ենք տալիս նախ թեստավորել test միջավայրում, հետո օգտագործել իրականում։