RefundCredit
Purpose
Implements the Credit transaction (a non-referenced refund transaction) with a payment gateway.
Mandatory
No.
Input Parameters
An associative array that contains the following values:
Param name | Description | Type |
---|---|---|
config
|
The plug-in configuration values saved in the Billing database. | array |
environment
|
The Billing environment information. | Environment |
account_info
|
The account's details. | AccountDetails |
vendor_info
|
The vendor's details. | AccountDetails |
document_info
|
The payment document description. | DocumentInfo |
payment_method
|
Attributes of the previously saved payment method. This contains name-value pairs returned by the |
array |
previous_transaction_data
|
(Optional) Data saved in the previous transaction. This contains name-value pairs returned previously in the |
array |
|
The transaction category for merchant-initiated payments (relevant and available only for
|
string |
|
The parameter that defines whether it is the MOTO transaction. Possible values are:
|
boolean |
|
The transaction initiator. Possible values are:
|
string |
ref_no
|
Billing transaction identifier. | integer |
transaction_amount
|
The transaction amount. | double |
currency_iso
|
The currency of the transaction amount in the ISO format (for example, USD or EUR). | string |
|
The current language. | string |
client_ip
|
The IP from the client computer. | string |
The example of input parameters is shown below as a JSON object:
{
"config": {
"auth_code": "",
"format": "json",
"gateway_url": "https://demo-payment-gateway.com",
"test_mode": "0" },
"environment": {
"lang": "en",
"notify_url": "https://example.sandboxes.int.zone/bss-www/nologin/srv/BM/ProcessNotificationJsonPlugin/swep/action/notify/EActivityID/90/",
"return_url": "https://example.sandboxes.int.zone/bss-www/nologin/srv/BM/JsonRedirectPaymentOk/swep/action/notify/EActivityID/90/",
"return_url_3dsecure": "https://example.sandboxes.int.zone/bss-www/nologin/srv/BM/JsonCallback3D/swep/action/notify/EActivityID/90/",
"return_url_failed": "https://example.sandboxes.int.zone/bss-www/nologin/srv/BM/JsonRedirectPaymentFailed/swep/action/return/EActivityID/90/",
"return_url_ok": "https://example.sandboxes.int.zone/bss-www/nologin/srv/BM/JsonRedirectPaymentOk/swep/action/return/EActivityID/90/",
"system_host": "bss.int.zone" },
"vendor_info": {
"id": 1,
"type": 0,
"vendor_id": null,
"is_corporate": true,
"name": "ServicePro",
"lang": "en",
"admin_fname": "Charlie",
"admin_mname": null,
"admin_lname": "Root",
"admin_email": "root@test.oss",
"admin_phone": {
"country_code": "1",
"area_code": "408",
"number": "4567890",
"extention": null
},
"admin_fax": {
"country_code": null,
"area_code": null,
"number": null,
"extention": null
},
"billing_fname": "Charlie",
"billing_mname": null,
"billing_lname": "Root",
"billing_email": "root@test.oss",
"billing_phone": {
"country_code": "1",
"area_code": "408",
"number": "4567890",
"extention": null
},
"billing_fax": {
"country_code": null,
"area_code": null,
"number": null,
"extention": null
},
"technical_fname": "Charlie",
"technical_mname": null,
"technical_lname": "Root",
"technical_email": "root@test.oss",
"technical_phone": {
"country_code": "1",
"area_code": "408",
"number": "4567890",
"extention": null
},
"technical_fax": {
"country_code": null,
"area_code": null,
"number": null,
"extention": null
},
"tax_ex_number": null,
"address_address1": "500 SW 39th Street, Suite 200",
"address_address2": null,
"address_city": "Renton",
"address_state": "WA",
"address_zip": "98057",
"address_country": "us" },
"account_info": {
"id": 1000002,
"type": 3,
"vendor_id": 1,
"is_corporate": false,
"name": "PHILIP Huel, Nicolas",
"lang": "en",
"billing_fname": "Philip",
"billing_mname": null,
"billing_lname": "Hoeger",
"billing_email": "philip.hoeger9934@ingrammicro.tld",
"billing_phone": {
"country_code": "1",
"area_code": "314",
"number": "8634391",
"extention": null
},
"billing_fax": {
"country_code": "1",
"area_code": "314",
"number": "8634391",
"extention": null
},
"tax_ex_number": "XXXX01001",
"address_address1": "575 Barfield Lane",
"address_address2": null,
"address_city": "Indianapolis",
"address_state": "IN",
"address_zip": "46254",
"address_country": "us" },
"document_info": {
"id": 72,
"total": "10.00",
"currency": "USD",
"description": "Refund" },
"payment_method": {
"token": "ef85e6c9c293c655898b5a60a5786e3a",
"paymethod_name": "**** **** **** 5062",
"external_id": "a5955ff876d79e48daa82361b97c2daa",
"initial_status": "OK",
"exp_date": "5/2025" },
"transaction_category": "C",
"transaction_moto": true,
"transaction_initiator": "MIT",
"plugin": "Example",
"action": "RefundCredit",
"ref_no": 90,
"transaction_amount": "10.00",
"currency_iso": "USD",
"current_lang": "en",
"client_ip": "10.194.251.28"}
Response
An associative array that contains the following keys:
Param name | Description | Type |
---|---|---|
STATUS
|
(Mandatory) The method execution status. Valid values for the Refund method are:
|
string |
TEXT
|
(Optional) The array that contains the following parameters:
|
array |
TRANSACTION_DETAIL
|
(Optional) The array that will be associated with the current transaction and will be represented back in unchanged form as the value of the Note: Billing looks up the |
array |
NEXT_TRANSACTION_GAP
|
(Optional) The delay, in seconds, to dispatch the CheckStatus method call. This parameter may be used when the When Billing receives this parameter, it will schedule the CheckStatus method call event to be dispatched in |
integer |
The example of a response is shown below as a JSON object:
{
"STATUS": "APPROVED",
"TRANSACTION_DETAILS": {
"trans_id": "1641568620" }
}
Example
The built-in Demo
plugin implements the RefundCredit
method. The example below shows how this plugin implements it:
function Demo_RefundCredit( $params ) {
if (!isset($params['transaction_amount'])) {
throw new Exception('No transaction amount is set');
}
if (!isset($params['currency_iso']) ) {
throw new Exception('No currency is set');
}
return array(
STATUS => STATUS_APPROVED,
TRANSACTION_DETAILS => array(
'trans_id' => _Demo_FakeTransactionId()
)
);
}