Refund Bank Transfer

The "Refunds" functionality allows external customers/users to request a refund of the amount paid. It is available through API or Front

Refunds API

PATCH {api_base_url}api/payin/{externalId}/refund

Headers

Name	Type	Description
Authorization *	String	JWT token in format Bearer eyJ0... For more information about authentication, please refer to Authentication

Request Body

Name	Type	Description
externalId*	String	An ID that is meaningful to you and your system. Must be unique.

200: OK Payin refunded

{
    "externalId": "XXXX",
    "internalId": "{{InternalId}}",
    "status": {
        "code": "902",
        "description": "REFUNDED",
        "detail": "The payin was refunded"
    }
}

400: Bad Request Payin not found

{
    "status": {
        "code": "400",
        "description": "ERROR",
        "detail": "Invalid operation"
    }
}

Request

curl --location --request PATCH 'https://api.stage.localpayment.com/api/payin/{{externalId}}/refund' \
--header 'x-client-code: 0000' \
--header 'Content-Type: application/json' \
--header 'Authorization:{{Token_Generated}}' \
--data '{
}'

Status OK

{
    "externalId": "{{externalId}}",
    "internalId": "{{InternalId}}",
    "status": {
        "code": "902",
        "description": "REFUNDED",
        "detail": "The payin was refunded"
    }
}

Bad Request

{
    "status": {
        "code": "400",
        "description": "ERROR",
        "detail": "Invalid operation"
    }
}

Create Payin Refund

• The transaction can only be refunded if the status is completed.

• The refund must be made to the total amount of the payin.

• The beneficiary and destination account information must be the same as the data from which the payment originates.

Authorization Refund Bank Transfer

• Your account must be set to require authorization for refunds.

• An administrator will need to authorize the refund before it can be processed.

• Administrators can authorize refunds from the "Pending Authorization" menu option within the "Refunds" menu.