BENEFICIARY: Perform Name Change

RSP can use this method to request amendment on beneficiary name. Amendment request will be based on the transaction status and corridors. For cash pickup transaction, only transaction with the payout status “In Process” or “Unclaim” is able to be amend. For banks transactions, the amendment is strictly based on the banks and country regulations.

Definition:

PUT v1/payments/transfers/{GTN}/requests/{transID}/change-name


Sample Request:

curl -v -X PUT http://staging-gloremit.tranglo.com:2014/v1/payments/transfers/G3717307424573/requests/2017110201/change-name \
-H "Content-Type: application/json \
-H "AuthorizationGLOREMIT <UID>:<PWD>:<rspSign>" \
-d '{
"beneFirstName": "Oppo",
"beneLastName": "Frank"
}'

Request Description

Parameter NameRequiredMin/Max LengthTypeRemark
UIDM5/50AlphanumericUsername for validation.
PWDM5/50AlphanumericPassword for validation, 3DES encrypted.
rspSignM32/50AlphanumericDigital signature of RSP.
(Please refer to Digital signature)
transIDC3/6AlphanumericUnique transaction ID used by RSP in Change Name method.
GTNM14/14AlphanumericTransaction GTN number. (14 characters)
beneFirstNameM1/100AlphanumericNew beneficiary first name.
beneLastNameM1/100AlphanumericNew beneficiary last name.

Response Description

Sample Response:

{
    "TrxStatus":"946",
    "ChangeId":"null",
    "transID":"2017110201",
    "Description":"Duplicate Request"
}
Parameter NameRequiredTypeRemark
TrxStatusMNumericTransaction status response code.
(Please refer to Transaction status)
ChangeIDMAlphaNumeric 15-character change name ID.
transIDMAlphaNumericUnique Transaction ID from RSP.
DescriptionMAlphaNumericTransaction description or advice.

M= Mandatory, C= Conditional, O= Optional