Retrieve Payment Method

Retrieves a specific payment method by its unique ID.

HTTP Request

GET/api/payment/methods/:id

Authorization

Authorization

• Required: Yes
• Permission: Admin or Staff
• Authentication: Token-based (Authorization: Token <your_api_key>)

Path Parameters

Parameter	Type	Required	Description
id	Integer	Yes	Unique ID of the payment method to retrieve

Example Requests

🐍 Python

1import requests
2
3response = requests.get('http://www.example.com/api/payment/methods/123', 
4  headers={'Authorization': 'Token <your_api_key>'}
5)
6print(response.json())

🌐 Curl

1curl "http://www.example.com/api/payment/methods/123" \
2-H "Authorization: Token <your_api_key>"

Status Codes

Code	Description
200	Payment method retrieved successfully
400	Bad request — invalid parameters
401	Unauthorized — authentication required
403	Forbidden — insufficient permissions
404	Not found — payment method does not exist
500	Internal server error

Response Fields

Field	Type	Description
id	Integer	Unique ID of the payment method
backend	String	Backend identifier for the payment method
active	Boolean	Whether the payment method is active
order	Integer	Order of the payment method in the list
name	String	Name of the payment method
image_data	Object	Image details (read-only)
description	String	Description of the payment method
settings	Object	Additional settings for the payment method
created_at	String (ISO 8601)	Timestamp when the payment method was created
updated_at	String (ISO 8601)	Timestamp when the payment method was last updated

Image Data Structure

Field	Type	Description
id	Integer	Unique ID of the image
type	String	File type (e.g., image/jpeg)
name	String	Original file name
size	Integer	File size in bytes
human_readable_size	String	Human readable file size (e.g., 2.5 MB)
f	String	URL to access the image file
width	Integer	Image width in pixels
height	Integer	Image height in pixels
mode	String	Color mode (e.g., RGB, CMYK)

Settings Structure

this response field depends on the payment method backend type and may include fields such as:

Field	Type	Description
merchant_id	String	Merchant ID for payment gateway (e.g., Zarinpal)
api_key	String	API key for authenticating requests to the payment gateway